Integração via API para Produtos

URL: https://api.comexnfe.com.br/api/v2/produtos.json

Verbo HTTP: GET

Parâmetros opcionais:
codigo: Filtro por código, deve ser idêntico
descricao: Filtro por descrição, pode estar no início, no meio ou no fim
zerados: Ao ser incluído, retorna também os produtos sem quantidade em estoque.
ativos: Ao ser incluído, exibe apenas os produtos ativos no estoque. Por padrão, produtos inativos também são exibidos.
ultima_modificacao: Filtro por data de modificação. Apenas os produtos com data de modificação superior à data informada serão exibidos. O formato da data deve ser YYYY-MM-dd HH:mm:ss
integracao: Exibe atributos específicos para integrações com e-commerces. Abaixo, há mais detalhes
page: Página da busca

Paginação:
Para que a performance do servidor não seja afetada, todas as chamadas são paginadas a cada 100 itens. O JSON retornado possui as informações de paginação, como exemplificado abaixo, com as informações das páginas e do total.

Parâmetros obrigatórios:
api_key: A chave de acesso à API

Formato do retorno:

{ "pagination": {   "next_page": "/api/v2/produtos?api_key=&page=2",   // Também há um atributo "previous_page"   "total":  }, "produtos": [ // Primeiro item { "codigo": "0001", // Código "descricao": "Produto Teste", // Descrição "pu": 80.0, // Preço Unitário de Entrada "pu_saida": 150.0, // Preço Unitário de Saída "qtde": 1.0, // Quantidade em estoque "qtde_comprometida": 0.0 // Quantidade comprometida em pedidos "gtin": "7891111222226", "codigo_de_barras_interno": "978020137962", "ncm":"85369010", "ativo": true, "ultima_modificacao":"2017-06-09T07:43:27.745-03:00"

}, { "codigo": "TST02", "descricao": "Produto Teste 2", "pu": 3.5527, "pu_saida": 9.0, "qtde": 10.0, "qtde_comprometida": 5.0, "gtin": "7891111222226", "codigo_de_barras_interno": null, "ncm":"85369010", "ativo": true, "ultima_modificacao":"2017-06-09T07:43:27.745-03:00" }, { "codigo": "PROD03", "descricao": "Produto Teste 3", "pu": 37.54, "pu_saida": 66.0, "qtde": 1.0, "qtde_comprometida": 0.0, "gtin": "7891111222226", "codigo_de_barras_interno": "978020137962", "ncm":"85369010", "ativo": true, "ultima_modificacao":"2017-06-09T07:43:27.745-03:00" } ]}

Integrações

É possível solicitar informações específicas para uma integração. Por padrão, são exibidas apenas informações genéricas do produto. Para buscar informações específicas de um ecommerce, é preciso passar o parâmetro opcional integracao com a integração desejada.

Xtech

Ao fazer a requisição com o parâmetro integracao=xtech, é retornado um novo objeto xtech para cada um dos produtos, com suas respectivas categorias e características, ambas num array de strings.

Por exemplo, na requisição:

GET /api/v2/produtos.json?api_key=<API_KEY>&integracao=xtech

Teremos uma resposta parecida com a seguinte:

{
  "produtos": [
    {
      "id": 551590,
      "codigo": "001",
      "descricao": "LAMPADA LED AZUL",
      "informacoes_complementares": "",
      "descricao_completa": null,
      "peso_liquido": null,
      "peso_bruto": null,
      "pu": 10.47,
      "pu_saida": 30.0,
      "qtde": 5,
      "qtde_comprometida": 0,
      "qtde_armazenada": 0,
      "gtin": null,
      "codigo_de_barras_interno": null,
      "ncm": "85392200",
      "ativo": true,
      "ultima_modificacao": "2018-07-27T17:31:33.085-03:00",
      "xtech": {
        "caracteristicas": [],
        "categorias": ["1196452", "1196453", "1196454"]
      }
    },
    {
      "id": 1096911,
      "codigo": "01576081",
      "descricao": "LAMPADA LED BRANCO FRIO",
      "informacoes_complementares": "",
      "descricao_completa": null,
      "peso_liquido": null,
      "peso_bruto": null,
      "pu": 30.0,
      "pu_saida": 40.0,
      "qtde": 6,
      "qtde_comprometida": 0,
      "qtde_armazenada": 0,
      "gtin": null,
      "codigo_de_barras_interno": null,
      "ncm": "85437099",
      "ativo": true,
      "ultima_modificacao": "2018-07-27T17:31:33.264-03:00",
      "xtech": {
        "caracteristicas": ["1050672"],
        "categorias": ["1196452", "1196453", "1196455"]
      }
    }
  ],
  "pagination": {
    "total": 590,
    "next_page": "/api/v2/produtos?api_key=&integracao=xtech&page=2&per_page=1"
  }
}