Guias de Integração

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

Guias técnicos organizados por tema. Leia na ordem sugerida para uma primeira integração, ou vá direto ao tópico que precisa.

Fundamentos

• Visão geral — arquitetura, fluxo de dados e papéis
• Autenticação — Basic Auth, header x-parceiro-id e descoberta de identidade
• Modos de operação — diferença entre FILTRADO e TOTAL

Operações principais

• Liquidação — criar pedidos, confirmar e cancelar
• Webhooks — receber eventos, verificar assinatura e tratar retentativas
• Idempotência — chaves de idempotência e comportamento em duplicatas

Referência operacional

• Rate limits — limites por credencial e comportamento em 429
• Erros — catálogo de códigos, causas e ações recomendadas