Emitir Factura Electrónica (FE): estructura práctica de integración

¿Qué esperamos de tu sistema para emitir Factura Electrónica?

Para integrar tu sistema con nuestro servicio, no necesitas cambiar tu forma de trabajar. Lo único que necesitas es poder enviar la información de cada venta en un formato ordenado y claro.

Nosotros nos encargamos del resto del proceso.

Cómo funciona de forma simple

1. Tu sistema registra una venta normalmente.
2. Envía los datos del comprobante a nuestro servicio.
3. Nosotros procesamos el documento.
4. Puedes consultar el estado cuando lo necesites.

Punto de envío

Tu sistema debe enviar la información al siguiente punto:

POST /api/v1/documentos

Qué debe incluir la solicitud

Para identificar tu integración, se debe incluir:

X-API-KEY: TU_API_KEY
Content-Type: application/json

Ejemplo de información que debe enviar tu sistema

Este es un ejemplo de cómo debe estructurarse la información. Los valores son ilustrativos:

{
    "tipo_documento": "01",
    "moneda": "CRC",
    "condicion_venta": "01",
    "medio_pago": [
        {
            "medio_pago_tipo": "01"
        }
    ],
    "receptor": {
        "tipo_identificacion": "01",
        "numero_identificacion": "101010101",
        "nombre": "Cliente Demo",
        "correo": "cliente@email.com"
    },
    "lineas": [
        {
            "numero_linea": 1,
            "cantidad": 1,
            "detalle": "Producto demo",
            "precio_unitario": 1000,
            "unidad_medida": "Unid",
            "codigo_cabys": "1234567890123",
            "descuentos": [],
            "impuestos": [
                {
                    "codigo": "01",
                    "codigo_tarifa_iva": "08",
                    "tarifa": 13
                }
            ]
        }
    ]
}

Qué es importante tener en cuenta

• Los datos deben ser reales y coherentes con la operación.
• El sistema debe poder identificar cada documento enviado.
• La información debe incluir el detalle de la venta.
• No es necesario manejar procesos complejos dentro de tu sistema.

En qué casos aplica esta integración

• Sistemas de facturación propios.
• Puntos de venta.
• Sistemas administrativos o ERP.
• Plataformas de venta en línea.