Saltar al contenido

API v1 · OAuth 2.0 · Servidor a servidor

Factura a la DIAN desde tu propio sistema.

Conta360 ya tiene los productos, los precios, los clientes, el inventario y la conexión con la DIAN de la empresa. Tu sistema pide el catálogo, manda el pedido y Conta360 emite la factura, la valida ante la DIAN, la contabiliza y mueve el inventario.

terminal
$ curl -X POST https://app.conta360.co/api/v1/facturas \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: pedido-00184" \
  -d '{ "pedido": "Mesa 7 · 184",
        "items": [{ "codigo": "P-0007", "cantidad": 2 }],
        "pagos": [{ "forma": "1", "metodo": "49" }] }'

HTTP/1.1 201 Created
{
  "data": {
    "estado": "validated",
    "estado_nombre": "Validada DIAN",
    "numero": "SETP990000001",
    "cufe": "a1b2…"
  }
}

URL base de la API https://app.conta360.co/api/v1

Cómo funciona

Cuatro llamadas, de cero a factura

  1. 01

    Pide un token

    Cambia el client_id y el client_secret por un token de una hora.

  2. 02

    Trae el catálogo

    Productos, precios e impuestos salen siempre de Conta360.

  3. 03

    Emite la factura

    Una llamada con el pedido y una Idempotency-Key estable.

  4. 04

    Consulta el estado

    Si no recibiste respuesta, pregunta antes de reintentar.

Caso típico

El POS de un restaurante

Un POS de restaurante toma pedidos y genera comandas. Al cerrar la cuenta, si el cliente pide factura electrónica, el POS la emite con una llamada. Si no la pide, el POS no llama a Conta360 y el pedido sigue siendo solo suyo.

Referencia

Lo que puedes hacer

Antes de escribir código

Tres reglas que no se negocian

Descargas

Llévate el contrato y pruébalo

¿Primera vez con Postman? Mira cómo importar la colección.

Buscar en la documentación