Atualizada: 08/08/2024

[POST] /catálogos/<CATALOG_ID>/produtos



[POST] /catalogs/<CATALOG_ID>/produtos

Objetivo:

Faça upload de produtos para um catálogo do Botmaker

Primeiramente é necessário criar um catálogo onde serão adicionados os produtos:

Criar Catálogo:

curl -X POST --header 'Tipo de conteúdo: aplicativo/json' --header 'Aceitar: aplicativo/json' --header 'token de acesso: <TOKEN>' -d '{ \

  "title": "Meu Catálogo", \

  "description": "Meu primeiro catálogo" \

}' 'https://go.botmaker.com/api/v1.0/catalogs'

O CATALOG_ID da resposta é obtido:

{

 "id": "1BKOTFLQCVAG0BSTLF00"

}

Categoria de carregamento:

curl -X POST --header 'Tipo de conteúdo: aplicativo/json' --header 'Aceitar: aplicativo/json' --header 'token de acesso: <TOKEN>' -d '{ \

  "categorias": [\

    {\

      "title": "Minha categoria", \

      "description": "Minha primeira categoria", \

      "código": "1" \

    } \

  ], \

  "upsert": verdadeiro\

}' 'https://go.botmaker.com/api/v1.0/catalogs/<CATALOG_ID>/categories'

Carregamento do produto:

curl --location --request POST 'https://go.botmaker.com/api/v1.0/catalogs/<CATALOG_ID>/products' \

--header 'Tipo de conteúdo: aplicativo/json' \

--header 'Aceitar: aplicação/json' \

--header 'token de acesso: <TOKEN>' \

--data-raw '{

  "produtos": [

    {

      "sourceId": "1",

      "título": "papa branco",

      "descrição": "batata branca escovada",

      "palavras-chave": "papa branca",

      "preço": "1000",

      "preçodevenda": "399",

      "moeda": "ARS",

      "imageLink": "https://motegreenmarket.com.ar/wp-content/uploads/2020/02/papa-blanca.jpg",

      "additionalImageLink_1": "https://motegreenmarket.com.ar/wp-content/uploads/2020/02/papa-blanca.jpg",

      "ordem": 0,

      "categoriaCode": "1",

      "Disponibilidade: Em estoque"

    }

  ],

  "upsert": verdadeiro

}'

Estrutura da solicitação:

  • ID de origem [corda] Identificador do produto, geralmente chamado de SKU.
  • título [corda] Nome do produto
  • descrição [corda] descrição do produto
  • palavras-chave [corda] Palavras-chave para pesquisar o produto
  • preço [corda] Preço do produto
  • preço de venda [corda] Preço de oferta do produto (opcional)
  • moeda [corda] Moneda local, utilizar el country ISO code https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3
  • imagemLink [corda] Link para a imagem principal do produto
  • adicionalImageLink_1 [corda] Link para a imagem adicional do produto, você pode inserir até 5 imagens. (Opcional)
  • ordem [corda] Pedido de produto
  • categoriaCódigo [corda] Código da categoria (opcional). Uma categoria deve ser criada previamente.
  • disponibilidade [corda] Status do produto. Opções possíveis: InStock | Fora de estoque
  • virar [boleano] Crie o produto se ele não existir.

Produto com subitens:

curl -X POST --header 'Tipo de conteúdo: aplicativo/json' --header 'Aceitar: aplicativo/json' --header 'token de acesso: <TOKEN>' -d '{ \

  "produtos": [ \

    {\

      "sourceId": "1234", \

      "title": "Combo de Hambúrguer", \

      "descrição": "Descrição do combo", \

      "preço": 500, \

      "preçodevenda": 400, \

      "moeda": "ARS", \

      "isComposite": verdadeiro, \

      "link": "https://media-cldnry.s-nbcnews.com/image/upload/t_fit-1240w,f_auto,q_auto:best/rockcms/2022-08/220805-border-collie-play-mn-1100 -82d2f1.jpg",\

      "imageLink": "https://media-cldnry.s-nbcnews.com/image/upload/t_fit-1240w,f_auto,q_auto:best/rockcms/2022-08/220805-border-collie-play-mn-1100 -82d2f1.jpg",\

      "cor": 1, \

      "CategoriaCode": "1", \

      "Disponibilidade: Em estoque", \

      "additionalImageLink_1": "https://media-cldnry.s-nbcnews.com/image/upload/t_fit-1240w,f_auto,q_auto:best/rockcms/2022-08/220805-border-collie-play-mn-1100 -82d2f1.jpg",\

      "estrutura composta": [\

        {\

          "id": "4-O1", \

          "tipo": "SELECIONAR", \

          "título": "Hambúrguer", \

          "valores": [\

            {\

              "id": 216, \

              "title": "Batatas fritas", \

              "preçoextra": 29,9 \

            }, \

            {\

              "id": 217, \

              "title": "Bebida", \

              "preçoextra": 29,9\

            } \

          ] \

        }, \

        {\

          "id": 335, \

          "title": "Mostarda", \

          "tipo": "VERIFICAR", \

          "valor padrão": falso, \

          "preçoextra": 69,9 \

        }, \

        {\

          "id": 338, \

          "title": "Maionese", \

          "tipo": "VERIFICAR", \

          "valor padrão": falso, \

          "preçoextra": 114,9\

        }, \

        {\

          "id": 364, \

          "título": "Ketchup", \

          "tipo": "VERIFICAR", \

          "valor padrão": falso, \

          "preçoextra": 39,9\

        } \

      ] \

    } \

  ], \

  "upsert": verdadeiro\

} \

' 'https://go.botmaker.com/api/v1.0/catalogs/<CATALOG_ID>/products'