Operacao Direta (POST /v1/operations/direct)

Cria uma operacao de antecipacao em uma unica chamada, sem registrar o recebivel no estoque antes. Voce envia os dados do cedente e a lista de recebiveis (cada um com o seu sacado) no mesmo corpo.

Quando usar: integracoes que ja tem todos os dados em maos e nao precisam do ciclo de estoque (registrar -> simular -> solicitar). Para o fluxo passo a passo via estoque, veja o Getting Started.

Idempotencia obrigatoria

Esta e uma rota financeira: envie sempre o header Idempotency-Key (UUID). Reenviar a mesma chave com o mesmo corpo retorna a operacao original (nao duplica); com corpo diferente retorna 409 idempotency_key_reused_with_different_body.

Estrutura do corpo

Campo	Obrig.	Descricao
name	Sim	Nome / razao social do cedente
type	Sim	F (pessoa fisica/CPF) ou J (juridica/CNPJ)
cpf / cnpj	Condicional	cpf se type=F; cnpj se type=J
email	Sim	E-mail do cedente (notificacoes + contrato)
bank	Sim	Dados de pagamento. { "use_document_pix": true } paga via PIX no documento do cedente
receivables	Sim	Lista de recebiveis a antecipar (ver abaixo)
trade_name, phone, address	Nao	Dados adicionais do cedente
fees	Nao	Taxas da operacao. Se omitido, aplica a hierarquia cedente > sacado > policy
product_id, policy_id	Nao	Selecao de produto / override de policy do originador

Cada item de receivables exige: external_id, payer_name, payer_document, net_face_value, requested_advance_value, due_date (campos de taxa por item sao opcionais). O schema completo, campo a campo, esta na Referencia Tecnica.

Exemplo

curl -X POST "https://receivables-api.zemocapital.com/v1/operations/direct" \
  -H "X-Client-Id: $CLIENT_ID" \
  -H "X-Client-Secret: $CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "name": "Comercio XYZ LTDA",
    "type": "J",
    "cnpj": "12345678000190",
    "email": "financeiro@comercioxyz.com.br",
    "bank": { "use_document_pix": true },
    "receivables": [
      {
        "external_id": "NF-2026-001",
        "payer_name": "Industria ABC SA",
        "payer_document": "98765432000110",
        "net_face_value": "10000.00",
        "requested_advance_value": "10000.00",
        "due_date": "2026-08-15"
      }
    ],
    "fees": { "monthly_rate_pct": 3.5, "floating_days": 2 }
  }'

Resposta (201):

{
  "id": "01970dc6-...",
  "display_number": "OP-A1B2C3D4-E5F6G7H8",
  "status": "WAITING_APPROVAL",
  "opr_gross_face_value": "10000.00",
  "opr_net_face_value": "10000.00",
  "opr_liquid_value": "9424.66",
  "opr_net_liquid_value": "9424.66"
}

A partir daqui o ciclo e o mesmo do fluxo via estoque: aprovacao (se WAITING_APPROVAL), contrato (ZapSign), pagamento PIX ao cedente e conciliacao. Veja o Lifecycle.