Quickstart

Este guia mostra o caminho mínimo para iniciar uma integração com a API do app da Antecipa Fácil.

1. Autentique

curl -X POST https://api.antecipafacil.net.br/api/auth/v1/token \
  -H "Content-Type: application/json" \
  -d '{
    "email": "integracao@empresa.com.br",
    "password": "********"
  }'

Guarde o token access em um cofre de segredos ou sessão segura do seu backend.

2. Descubra as empresas do usuário

curl https://api.antecipafacil.net.br/api/company/v1/get-user-companies \
  -H "Authorization: Bearer <access_token>"

A resposta retorna as empresas e papéis disponíveis para o usuário. Para endpoints operacionais, use o company_role_id correspondente ao papel da empresa no fluxo.

3. Consulte dados da empresa

curl https://api.antecipafacil.net.br/api/company/v1/{company_role_id} \
  -H "Authorization: Bearer <access_token>"

Substitua {company_role_id} pelo identificador retornado no passo anterior.

4. Siga o fluxo do produto

Depois de autenticado e com o company_role_id, escolha o domínio:

Objetivo	Onde começar
Cadastrar ou revisar empresa	grupo Company na Referência da API
Criar cotação de recebíveis	grupo Quotation na Referência da API
Consultar títulos e enviar lances	grupo Marketplace na Referência da API
Listar documentos e anexos	grupo documents na Referência da API
Consultar conta escrow	grupo Escrow Account na Referência da API
Obter relatórios	grupo Reports na Referência da API

Dica

O APIM da Antecipa Fácil é o ponto público único. Na integração, sempre use https://api.antecipafacil.net.br e deixe o gateway encaminhar a rota para o backend correto.