Docs Entrar na plataforma

API de Integração · v1 · produção

Conecte seu ERP à antecipação de recebíveis.

Crie pré-autorizações para os fornecedores direto do seu sistema e acompanhe cada operação por webhooks assinados. Uma chave, quatro endpoints, eventos em tempo real.

Começar a integrar Ler a visão geral
Base URL https://app.oneos.com.br/api/integration/v1
seu-erp — integração Oneos

Seu ERP envia

POST /api/integration/v1/pre-authorizations
Authorization: Bearer oneos_sk_••••••••

{
  "supplier": {
    "cnpj": "11.222.333/0001-81",
    "email": "financeiro@fornecedor.com.br"
  },
  "invoice": { "amount": 18400, "dueDate": "2026-11-30" },
  "externalReference": "PED-4581"
}

A Oneos responde 201 Created

{ "id": 48213, "status": "IN_PRE_AUTH", … }

E avisa o seu sistema

POST https://erp.suaempresa.com.br/webhooks/oneos
x-oneos-event-type: pre_authorization.created
x-oneos-signature: t=1789481259,v1=9f2c…e41a

Assinatura HMAC-SHA256 válida

Como funciona

Três passos entre o seu ERP e o dinheiro na conta do fornecedor

  1. 01

    Gere uma chave de API

    Na plataforma, em Minha empresa › Integração. A chave aparece uma única vez.

    Authorization: Bearer oneos_sk_…
  2. 02

    Crie a pré-autorização

    Um POST com fornecedor e nota. O fornecedor recebe a oferta para antecipar.

    POST /pre-authorizations
  3. 03

    Receba os eventos

    Webhooks assinados contam cada passo: aceite, aprovação, pagamento, conclusão.

    x-oneos-signature: t=…,v1=…

Explore

Tudo o que você precisa para integrar

Início rápido

Da chave à primeira pré-autorização em minutos, com exemplos em cURL, Node.js, Python e PHP.

Pré-autorizações

Criar, cancelar e acompanhar o ciclo de vida de cada oferta ao fornecedor.

Webhooks

Catálogo de eventos, formato da entrega, verificação de assinatura e retentativas.

OpenAPI

Especificação gerada dos mesmos contratos que a API valida. Importe no Postman ou gere um cliente.
Esc