Confira as principais dúvidas sobre a integração via API com o TRACKen. Aqui você encontra os endpoints disponíveis, parâmetros obrigatórios e exemplos de uso.

Como solicitar um usuário de API?

Para começar, é necessário criar um usuário de API. Envie as seguintes informações ao suporte do TRACKen:

• Nome da Loja (Cliente)
• CNPJ
• Transportador
• IP FIXO
• Propósito da Integração: (Importação de pedidos, emissão de etiquetas ou consulta de histórico)

Após o cadastro, você receberá as credenciais (username e password) para autenticação.

Como enviar um pedido?

URL Produção: https://tracken.app.br/tracken/api/pedido
Método: POST
Headers:

• Authorization: Basic base64("username":"password")
• Content-Type: application/json

Payload (JSON):

• cnpjCpfTransportadora – Documento da transportadora (obrigatório)
• idEnvio – Código de barras ou QRCode que será bipado (obrigatório)
• idVenda – Número da nota fiscal (obrigatório)
• dtCriacao – Data no formato “YYYY-MM-DD HH24:MI:SS”
• vlPago – Valor da nota fiscal (obrigatório para seguro)
• peso – Peso em gramas (integer)
• tipoEndereco – “R” residencial, “C” comercial ou null
• cnpjCpfVendedor – Documento do vendedor (obrigatório)
• cliente – Nome fantasia da loja (obrigatório)
• razaoSocial – Razão social da loja (obrigatório)
• codCliente – Código parceiro (obrigatório)
• cepVendedor – CEP da coleta (obrigatório)
• nomeComprador – Nome do destinatário (obrigatório)
• enderecoEntrega – Endereço com número e complemento (obrigatório)
• bairroEntrega – Bairro de entrega (obrigatório)
• cidadeEntrega – Cidade de entrega (obrigatório)
• estadoEntrega – Estado da entrega (obrigatório)
• cepEntrega – CEP da entrega (obrigatório)
• telefoneComprador – Telefone do destinatário (obrigatório)
• codServico – 1 para Mercado Envios Flex, 2 para ecommerce/avulso (obrigatório)
• Demais campos opcionais: localRetirada, numeroRetirada, complementoRetirada, bairroRetirada, cidadeRetirada, estadoRetirada, cnpjCpfComprador, ieVendedor, chave_nf, ieComprador, telefoneVendedor, emailVendedor, largura, altura, comprimento, latitudeDestino, longitudeDestino, volume

Respostas:

• 201 Created – Pedido cadastrado com sucesso (retorna os dados do pedido)
• 400 Bad Request – Erro nos dados enviados
• 401 Unauthorized – Autenticação inválida
• 404 Not Found – Endpoint não encontrado
• 409 Conflict – Conflito (ex.: pedido já existe)

Como obter o histórico de um pedido?

URL Produção: https://tracken.app.br/tracken/api/pedido/historico
Método: GET
Headers:

• Authorization: Basic base64("username":"password")
• cpfcnpjtransportadora: Documento da transportadora

Parâmetros (obrigatório informar pelo menos um):

• codremessa – integer
• numpedido – string
• notafiscal – string

Respostas:

• 200 Success – Retorna uma lista com o histórico do pedido (status, data, hora, recebedor, documento)
• 400 Bad Request – Erro nos parâmetros
• 401 Unauthorized – Autenticação inválida
• 403 Forbidden – Sem permissão
• 404 Not Found – Pedido não encontrado

Como obter a etiqueta de um pedido em PDF?

URL Produção: https://tracken.app.br/tracken/api/pedido/etiqueta/pdf
Método: GET
Headers:

• Authorization: Token <token> (fornecido pelo suporte)

Parâmetros:

• filial – CPF/CNPJ da transportadora (obrigatório)
• remessa – Código da remessa (obrigatório um dos três)
• notafiscal – Número da nota fiscal (obrigatório um dos três)
• pedido – Número do pedido (obrigatório um dos três)

Respostas:

• 200 Success – Retorna o conteúdo do arquivo PDF
• 400 Bad Request – Parâmetros inválidos
• 401 Unauthorized – Token inválido
• 404 Not Found – Etiqueta não encontrada
• 409 Conflict – Conflito

Links da documentação

• Documentação completa: Google Docs
• Collection Postman: Baixar

Dúvidas?

Se ainda tiver dúvidas sobre a integração via API, fale com o suporte técnico.

Falar com Suporte TRACKen