Documentação API para Integradora

Autenticação

Todas as requisições para recursos da API irão conter o token de autorização presente no header da request.

Devem ser enviados da seguinte forma:

Content-Type:application/json

TOKENTEK: {{TOKEN}} 

O token de acesso deverá ser disponibilizado pela plataforma onde será enviado um e-mail com token ao vendedor.

Códigos de erros

401 Ausência de um dos Tokens no header ou token não existe

403 Token revogado ou inválido

405 Método de requisição, inválido.

400 Erro no JSON enviado

500 Erro interno de servidor.

Ambiente

Link para Ambiente em Produção.

Link para Ambiente em Homologação.

Atualizar Estoque

Atualizar estoque do item de Sku: 2568 para quantidade igual a 5.

HEADERS

Content-Type application/json

TOKENTEK {{TOKEN}}

Exemplo Request

curl --location -g --request PUT '{{LINK}}/items/2568/stock' \
--header 'Content-Type: application/json' \
--header 'TOKENTEK: {{TOKEN}}' \
--data-raw '{
   "quantity":"5"
}

Atualizar Status

Atualizar status do item Sku: 2568 para status igual a 0 - Ativo.

HEADERS

Content-Type application/json

TOKENTEK {{TOKEN}}

Exemplo Request

curl --location -g --request PUT '{{LINK}}/items/2568/status' \
--header 'Content-Type: application/json' \
--header 'TOKENTEK: {{TOKEN}}' \
--data-raw '{
   "active":"0"
}

Importar Documentos

Buscar novos pedidos no site da Integração respeitando o limite de 250 ordens.

HEADERS

TOKENTEK {{TOKEN}}

Exemplo Request

curl --location -g --request GET '{{LINK}}/orders/status/new/?limit=250' \  
--header 'TOKENTEK: {{TOKEN}}'

Solicitar Faturamento

Autoriza à Integração a emissão da nota fiscal de venda para o destinatário final. Somente serão autorizados documentos em carga e que estejam totalmente reservados.

Solicitar liberação do pedido com Ordem de Compra 123456.

Content-Type application/json

TOKENTEK {{TOKEN}}

Exemplo Request

curl --location -g --request PUT '{{LINK}}/orders/123456/billing/authorize' \
--header 'Content-Type: application/json' \
--header 'TOKENTEK: {{TOKEN}}' \