Perguntas frequentes
Recebo 401 e não sei por quê
A API devolve sempre a mesma mensagem, por segurança. Confira nesta ordem: os dois cabeçalhos estão presentes com esses nomes exatos; a API Key foi copiada inteira; o Secret é o da mesma credencial; a credencial está ativa e dentro da validade no ERP; se ela tem lista de IPs, o seu está nela. Se tudo confere, informe data, hora e a API Key ao suporte: o motivo está registrado no log.
Minha loja atende mais de uma filial
Uma credencial por filial. Não há como pedir dados de outra filial com a mesma credencial, e nenhum endpoint aceita filial como parâmetro.
Por que os enums vêm como número?
Porque o número é o que está gravado no ERP e o que não muda. O texto ao lado, em *Descricao, é o
que a tela do ERP mostra e pode ser reescrito. Guarde o número; exiba o texto.
Enviei um pedido e a conexão caiu
Reenvie com a mesma chavePedidoEcommerce. Se o primeiro envio entrou, a resposta traz o protocolo
dele com jaProcessado: true; se não entrou, o reenvio cria o pedido. Nunca há duplicidade.
O estoque não baixou depois do pedido
Correto: o recebimento não reserva nem baixa estoque. A baixa acontece quando a filial fatura o pedido no ERP. Até lá, desconte na loja o que já vendeu.
Um produto sem variação tem grade?
Tem uma, a grade padrão do ERP. No pedido você pode omitir grade nesse produto; a API resolve
sozinha porque só existe uma ativa na filial.
Que tipo de destinatário informar no pedido?
Leia /tipos-destinatario uma vez e escolha pelo que o comprador declarou: contribuinte de ICMS,
isento ou não contribuinte, e se a UF dele é a mesma da filial (operação interna) ou outra
(interestadual). Consumidor final pessoa física costuma ser "não contribuinte". Quem confirma a regra
fiscal é o contador da filial.
As datas vêm sem fuso horário
Sim. Toda data é a hora local da filial, no formato ISO 8601 sem sufixo de fuso, como
2026-09-25T10:30:00. Envie no mesmo formato.
Posso mandar números entre aspas?
Não. "quantidade": "2" é recusado com 400 e a mensagem "Campo 'itens[0].quantidade' com valor
inválido para o tipo esperado". Números são números, decimais com ponto. O mesmo vale para grade e
cor, que são códigos numéricos: "grade": "P" é recusado, "grade": 2 entra.
Como sei que a API mudou?
Mudança compatível, como campo novo ou endpoint novo, entra na v1 e é comunicada pela Objetiva.
Mudança incompatível vira /api/v2/, e a v1 continua no ar por um período anunciado com a mudança.
O download de imagem devolve JSON no erro?
Sim. Só o 200 é a imagem; 400, 401, 429 e 500 vêm com o envelope JSON, como em todo endpoint.