Arma Factura y Crédito Fiscal desde tu propio sistema.

1. Genera tu clave

En Qontador, Configuración → Conectores → «Generar clave de API». Empieza con qk_ y se muestra una sola vez; guárdala como secreto en tu servidor, nunca en el navegador.

2. Manda la venta

Un POST a /api/v1/ventas con el receptor, los ítems y una referencia tuya (el número de pedido). Qontador arma la Factura o el Crédito Fiscal para que lo revises. La declaración y la presentación ante Hacienda las haces tú o tu contador.

3. Entrega el comprobante

Puedes descargar el PDF y el JSON. La venta queda en Ventas, en el libro de ventas y en el débito de IVA. El Excel del F-07 sigue siendo el anexo de compras. Quien lo presenta eres tú o tu contador.

Claude Code

claude mcp add --transport http qontador https://qontador.com/api/mcp \
  --header "Authorization: Bearer qk_TU_CLAVE"

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "qontador": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://qontador.com/api/mcp",
        "--header", "Authorization: Bearer qk_TU_CLAVE"
      ]
    }
  }
}

GET /api/v1/empresa

Comprueba la clave y devuelve la empresa, el NIT, si Hacienda está configurada y si el registro sin transmisión está activo.

POST /api/v1/ventas

Arma una Factura (01) o un Crédito Fiscal (03). Con el ajuste de empresa o con transmitir: false solo la registra. Idempotente por referencia.

GET /api/v1/ventas?referencia=

Busca una venta por tu referencia, o lista las últimas emitidas por API con ?limit=.

GET /api/v1/ventas/{id}

Estado del documento armado, para que lo revises antes de presentarlo.

GET /api/v1/ventas/{id}/pdf

Representación gráfica del documento en PDF, para revisarla.

GET /api/v1/ventas/{id}/json

El JSON del documento armado, para revisarlo antes de presentarlo.

Petición

curl -X POST https://qontador.com/api/v1/ventas \
  -H "Authorization: Bearer qk_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "referencia": "pedido-1042",
    "tipoDte": "01",
    "receptor": { "nombre": "Ana Pérez", "tipoDocumento": "13", "numDocumento": "01234567-8", "correo": "ana@ejemplo.com" },
    "items": [
      { "descripcion": "Camisa de lino", "cantidad": 2, "precioUni": 25.00 },
      { "descripcion": "Envío", "tipoItem": 2, "cantidad": 1, "precioUni": 3.50 }
    ],
    "precios": "con_iva",
    "formaPago": "03",
    "transmitir": false
  }'

Respuesta · datos de ejemplo

Qontador arma la Factura y el Crédito Fiscal y prepara el F-07 y los libros para que los revises. Quien declara y presenta ante Hacienda eres tú o tu contador.

{
  "id": "cm3x…",
  "referencia": "pedido-1042",
  "estado": "registrado",
  "transmitido": false,
  "tipo": "Factura",
  "ambiente": null,
  "numeroControl": "REG-01-pedido-1042",
  "codigoGeneracion": "6F0A…",
  "selloRecibido": null,
  "totalPagar": 53.5,
  "totalIva": 6.15,
  "enlaces": {
    "pdf": "https://qontador.com/api/v1/ventas/cm3x…/pdf",
    "json": "https://qontador.com/api/v1/ventas/cm3x…/json",
    "consultaPublica": null
  }
}