Perguntas Frequentes (FAQ)

Respostas rápidas para as dúvidas mais comuns na integração com a API.

Onde consigo o Token e o Identificador da Loja?

No painel da loja, em Sistema → Configurações Gerais → API de Acesso Externo → Atualizar Token. Veja o passo a passo em Geração de Token.

Ao gerar um novo Token, o antigo continua funcionando?

Não. Ao clicar em Atualizar Token, o token anterior é invalidado. Atualize o token nas suas integrações após gerar um novo.

Qual é o limite de requisições?

30 requisições por minuto. Veja os demais padrões em Considerações Gerais.

Qual o máximo de registros por página?

100 registros por página. Use os parâmetros Pagina e QtdPorPagina na Query. Veja Paginação.

Posso criar ou editar clientes pela API?

Não. O módulo de Clientes é somente leitura (consulta). O cadastro de clientes é feito pela própria loja/checkout. Veja Clientes.

Como altero o estoque de um produto?

O estoque não é alterado pelo endpoint de edição de produto. Use o endpoint específico de estoque. Veja Gerenciar Estoque.

Como recebo pedidos sem ficar consultando a API o tempo todo?

Use o recurso de Webhook: você é notificado automaticamente quando um pedido é criado, pago, enviado ou concluído. Veja Webhook.

Como sei qual código de status usar ao alterar um pedido?

Consulte a lista de status em GET /informacoes/status/. Veja Informações e Alterar Status.

Em qual formato devo enviar datas e valores?

Data no formato Ano-Mês-Dia; data e hora no formato Ano-Mês-Dia Hora:Minuto:Segundo; decimais com . (ponto). Veja Considerações Gerais.

Minha requisição falhou. Por onde começo?

Confira o elemento Mensagem no corpo da resposta e consulte a Solução de Problemas.

Não encontrou sua dúvida? Consulte o Glossário ou a documentação de referência no Simulador Online.