Integraciones / API REST

Su operación,
conectada.

Emita desde su tienda online, su sistema interno o su punto de venta. Una llamada, un documento válido.

POST/api/v1/integration/documents/
{
  "document_type": 33,
  "recipient": 42,
  "lines": [
    {
      "name": "Servicio anual",
      "unit_price": 47700
    }
  ]
}

202 Accepted

{ "document_id": 184, "status": "QUEUED" }
Ejemplo ilustrativo de integración

La emisión, dentro de su propio flujo

Conecte sus ventas con la facturación electrónica sin volver a ingresar cada operación manualmente. Su sistema prepara la solicitud y consulta el avance del documento mediante la API.

Tiendas online
Relacione los documentos con las ventas de su comercio.
Sistemas internos y ERP
Utilice los datos comerciales que ya administra su empresa.
Puntos de venta
Incorpore la emisión al flujo de atención de su negocio.

La conexión se implementa a través de la API; no se presupone un conector instalado para una tienda o proveedor específico.

Pruebe primero en SANDBOX

El entorno de pruebas permite enviar datos de ejemplo y revisar archivos de muestra sin transmitir al SII, consumir folios ni producir documentos tributarios válidos.

  1. Ingrese a la plataforma y abra Integración API.
  2. Genere una clave para SANDBOX y revise los ejemplos de la documentación.
  3. Pruebe datos, respuestas y manejo de errores desde su servidor.
  4. Verifique por separado los requisitos del emisor antes de habilitar emisión real.

SANDBOX facilita el desarrollo de su integración. CERT corresponde al proceso de certificación tributaria y tiene otros requisitos.

Una solicitud inicia el proceso

El contrato de la API documenta los campos, la autenticación y las respuestas. La creación de una operación y la aceptación tributaria del documento son estados distintos; consulte su resultado antes de informar una emisión como completada.

Solicitud ilustrativa · desde su servidor
POST /api/v1/integration/documents/
Authorization: ApiKey <clave-del-servidor>
Idempotency-Key: <identificador-de-su-venta>
Content-Type: application/json

La clave de idempotencia permite identificar solicitudes repetidas. Siga las reglas del contrato para evitar duplicados y manejar reintentos.

Claves por empresa y ambiente

Genere y revoque las claves desde la cuenta autorizada de su empresa. Manténgalas en su servidor y utilice el ambiente que corresponda a cada operación.

No incluya claves privadas en páginas públicas, repositorios, enlaces o aplicaciones que las expongan al navegador. Los certificados y las autorizaciones del contribuyente deben mantenerse vigentes para la emisión real.

Documentación para implementar

Consulte los endpoints, ejemplos y parámetros actualizados en la documentación pública. Si necesita evaluar cómo encaja la API en su operación, cuéntenos qué sistema quiere conectar.

Siga explorando

Conozca la plataforma en acción.

Probar la demo interactiva