Pular para o conteúdo principal
A API pública da Zouti dá acesso de leitura aos pedidos da sua conta: os pedidos em que a conta é dona e os de coprodução. Use-a para levar vendas, pagamentos, estornos e chargebacks para o seu ERP, CRM, planilha ou ferramenta de BI. A API é REST, só leitura (GET), e responde em JSON. Toda requisição se autentica com uma chave de API da conta.

​
Endereço base

Todo caminho desta documentação é relativo a esse endereço. Por exemplo, GET /v1/orders é https://api.zouti.com.br/v1/orders.

​
Convenções

Somente HTTPS. Requisição em HTTP recebe 400 com corpo em texto puro, sem redirecionamento. Se uma chave já foi enviada por HTTP, ela trafegou sem criptografia: revogue-a e crie outra.
  • JSON. As respostas da API vêm em JSON (application/json). As respostas geradas na borda (balanceador de carga e WAF) vêm sem corpo JSON e sem Request-Id: o 400 de uma requisição em HTTP, o 429 do limite de volume por IP, o 403 da proteção do WAF contra entradas maliciosas e um 5xx do balanceador de carga.
  • Valores em centavos. Todo valor monetário é um inteiro em centavos: 27730 é R$ 277,30.
  • Datas em ISO 8601, UTC. As datas das respostas vêm em UTC, como 2026-10-14T13:05:22.418Z. Os filtros de data aceitam qualquer fuso, mas o fuso é obrigatório: 2026-10-01T00:00:00-03:00 vale; 2026-10-01 é recusado.
  • Formato fixo. Campo sem valor vem null, nunca ausente. A exceção são as chaves dentro de metadata, que só aparecem quando existem no pedido.
  • Request-Id. Toda resposta da API traz o header Request-Id (req_...). Guarde-o no seu log e informe-o ao suporte quando relatar um problema.

​
Por onde começar

Primeiros passos

Crie uma chave e faça a primeira chamada em poucos minutos.

Autenticação

Como enviar a chave, guardá-la e trocá-la sem parar a integração.

Objeto pedido

Todos os campos do pedido e os valores de cada status.

Sincronização de pedidos

Mantenha uma cópia local dos pedidos com uma consulta periódica.