Crea tu API Key
Ve a Configuración → API Keys y genera una nueva clave.
Developers
Construye sobre Concilius
Accede a la API de Concilius para automatizar cobranza, sincronizar facturas y recibir eventos en tiempo real.
Inicio rápido
Tu primera solicitud
Usa tu clave para autenticarte y obtener tus facturas:
curl -X GET "https://api.concilius.io/api/v1/invoices/" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"Configura un webhook
Recibe eventos en tiempo real en tu servidor cuando algo cambie.
Autenticación
Todas las solicitudes deben incluir tu API Key en el header Authorization como Bearer token.
cURL
curl -X GET "https://api.concilius.io/api/v1/invoices/" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"Python
import requests
headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get("https://api.concilius.io/api/v1/invoices/", headers=headers)
print(resp.json())Node.js
const res = await fetch("https://api.concilius.io/api/v1/invoices/", {
headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const data = await res.json();Nunca expongas tu API Key en código del lado del cliente.
Endpoints principales
Método · RutaDescripción
GET /api/v1/invoices/List all invoices
POST /api/v1/invoices/Create an invoice
GET /api/v1/customers/List customers
GET /api/v1/overview/summaryGet overview KPIs
POST /api/v1/webhooksRegister a webhook
GET /api/v1/reconciliation/matchesGet reconciliation matches
GET /api/v1/collections/overdueGet overdue collections
GET /api/v1/reports/summaryGet reports summary
Webhooks
Concilius envía eventos a tu URL cuando ocurren cambios en tu organización.
Tipos de eventos
invoice.paidFired when an invoice status changes to paid
invoice.overdueFired when an invoice passes its due date
payment.receivedA payment is recorded in the system
customer.risk_changedCustomer AI risk score has changed
reconciliation.completedAutomatic reconciliation run finished
Ejemplo de payload
{
"event": "invoice.paid",
"timestamp": "2024-01-15T10:30:00Z",
"data": {
"invoice_id": "inv_abc123",
"amount": 15000.00,
"customer_id": "cust_xyz456"
}
}Límites de velocidad
El acceso por API (API keys) está incluido en el plan Scale.
Scale1,000 Solicitudes/min · 500,000 Solicitudes/día