API V2 de Antecipacao de Recebiveis
A API V2 da Zemo Capital permite que originadores (parceiros, intermediarios e cedentes self-service) realizem de forma segura e programatica a antecipacao de recebiveis.
O que voce pode fazer
- Cadastrar sacados e cedentes com dados bancarios verificados
- Registrar recebiveis (notas fiscais, duplicatas, contratos) no estoque
- Simular e criar propostas com calculo automatico de taxas e CET
- Converter propostas em operacoes com contrato digital (ZapSign)
- Acompanhar pagamentos via PIX Starkbank com conciliacao automatica
- Receber notificacoes em tempo real via webhooks HMAC-assinados
Fluxo da Antecipacao
Arquitetura
Ambientes
| Ambiente | Base URL | Uso |
|---|---|---|
| Dev | https://receivables-api-dev.zemocapital.com | Desenvolvimento e testes |
| Sandbox | https://receivables-api-sandbox.zemocapital.com | Integracao pre-producao |
| Producao | https://receivables-api.zemocapital.com | Producao real |
Sandbox
Todas as chamadas em sandbox retornam o header X-Zemo-Banner: SANDBOX para identificacao visual.
Convencoes
| Convencao | Detalhe |
|---|---|
| Prefixo de rotas | /v1/ |
| Datas/horarios | UTC (ISO 8601) |
| Valores monetarios | BRL com 2 casas decimais (string) |
| IDs | UUIDv7 (ordenados cronologicamente) |
| Soft-delete | Via archived_at (nunca DELETE fisico) |
| Respostas | JSON (ORJSONResponse) |
| Paginacao | ?limit=50&offset=0 |
| Idempotencia | Header Idempotency-Key obrigatorio em POST financeiro |