API REST · Conectada a la DIAN

API de facturación electrónica para Colombia

Conecta tu ERP, tu tienda o tu software con la DIAN en una sola integración. Emite facturas, notas, documento soporte, nómina electrónica y eventos RADIAN: Gemefact calcula, firma y transmite por ti.

Modo de pruebas sin costo de documentosHasta 100 documentos por peticiónColección de Postman

Solicita tu acceso de pruebas

Te creamos tu cuenta del portal y tu llave de API. Respondemos por WhatsApp.

¿Prefieres correo? Escríbenos a [email protected]

Todo en una sola API

Factura electrónicaNotas crédito y débitoDocumento soporteNómina electrónicaEventos RADIANPDF y correo
Beneficios

Factura electrónicamente sin complicarte

Tú te enfocas en vender; Gemefact se encarga de que cada documento salga bien armado hacia la DIAN.

Una sola integración

Un mismo punto de conexión para todos tus documentos electrónicos. Menos código que mantener.

Cálculo automático

Envías la venta y Gemefact calcula impuestos, retenciones y totales, asigna el consecutivo y genera el documento.

Facturación masiva

Envía hasta 100 documentos por petición y consulta después el estado de cada uno. Pensado para cierres de mes.

Resiste caídas de la DIAN

Si la DIAN no responde, tu documento queda pendiente con su número y Gemefact lo reintenta solo.

Seguimiento claro

Consulta el estado de cada documento y, si se rechaza, recibes el motivo exacto para corregirlo.

PDF y correo incluidos

Descarga el PDF con su código QR y envíalo por correo a tu cliente, con tu logo y tus colores.

Para desarrolladores

Una petición, un documento electrónico

Envías los datos de la venta en JSON. Gemefact calcula los totales, asigna el consecutivo, genera y firma el XML y lo transmite a la DIAN.

portal · documentos
Factura electrónicaSETP990000000
Aceptada
AdquirenteCliente S.A.S.
NIT800199436
Subtotal$100.000,00
IVA 19%$19.000,00
Total$119.000,00
CUFE generado · PDF con QRListo para enviar por correo

Ejemplo en modo de pruebas, sin validez fiscal.

curl -X POST https://api.gemefact.com/v1/facturas \
  -H "Authorization: Bearer $GEMEFACT_KEY" \
  -H "Idempotency-Key: pedido-778" \
  -H "Content-Type: application/json" \
  -d '{
  "forma_pago": "credito",
  "adquirente": {
    "tipo_documento": "31",
    "numero": "800199436",
    "nombre": "Cliente S.A.S."
  },
  "lineas": [
    {
      "descripcion": "Servicio de consultoría",
      "cantidad": 1,
      "precio": 100000,
      "impuestos": [
        {
          "tipo": "IVA",
          "porcentaje": 19
        }
      ]
    }
  ]
}'
Respuesta
{
  "numero": "SETP990000000",
  "estado": "aceptado",
  "totales": {
    "subtotal": "100000.00",
    "impuestos": "19000.00",
    "total": "119000.00"
  }
}
Cómo funciona

De tu primer contacto a tu primera factura

Cuatro pasos, sin trámites eternos y sin riesgo mientras pruebas.

  1. Solicita tu acceso

    Déjanos tus datos y cuéntanos qué vas a integrar. Un administrador crea tu cuenta.

  2. Recibe tus credenciales

    Te entregamos tu usuario del portal y tu llave de acceso a la API.

  3. Prueba sin riesgo

    Emite documentos de ejemplo en modo de pruebas, sin validez fiscal ni envíos a terceros.

  4. Habilita y factura

    Conectas tu certificado, habilitas tu empresa ante la DIAN y emites con validez fiscal.

Documentos

Los documentos que tu negocio necesita

Gemefact no es un software contable: es la pieza de facturación dentro del sistema que ya usas.

Factura electrónica

Venta de contado o a crédito, con impuestos, descuentos y retenciones. Descarga el PDF y envíalo por correo.

Notas crédito y débito

Devoluciones, anulaciones, rebajas y ajustes sobre una factura ya emitida.

Documento soporte

Para tus compras a proveedores que no están obligados a facturar, con su nota de ajuste.

Nómina electrónica

Transmite la nómina de cada trabajador con los valores que tu sistema ya liquidó, y ajústala si hubo un error.

Eventos RADIAN

Responde las facturas de tus proveedores: acuse, reclamo, recibo del bien y aceptación expresa.

Consulta de estado

Revisa en cualquier momento cómo va cada documento y qué hacer con los pendientes o rechazados.

Software houses y aliados

Ofrece facturación electrónica a tus propios clientes

Integras Gemefact una vez y la ofreces a todos tus clientes, cada uno con su propia cuenta, su certificado y su consumo.

  • Crea las cuentas de tus clientes y sus llaves de API desde tu propio panel.
  • Reparte paquetes de documentos entre ellos y mira cuánto usa cada uno.
  • Revisa las peticiones y las respuestas de la DIAN para darles soporte.
Seguridad y confianza

Tus datos y los de tus clientes, bien cuidados

  • Acceso por invitación. No hay registro público: un administrador crea cada cuenta.
  • Llaves protegidas. Límitalas por dirección de red o déjalas de solo lectura.
  • Certificado cifrado. Tu certificado y su clave se guardan cifrados y no se vuelven a mostrar.
  • Datos separados. Cada empresa ve únicamente su propia información.
Preguntas frecuentes

Lo que suelen preguntarnos

¿Necesito certificado digital para empezar?

No para probar: el modo de pruebas funciona sin certificado y sus documentos no tienen validez fiscal. Para emitir con validez ante la DIAN, tu empresa necesita su certificado de firma electrónica vigente y estar habilitada. Gemefact te guía en esos pasos desde el portal.

¿Cómo empiezo?

Déjanos tus datos y un administrador crea tu cuenta del portal. Recibes tu usuario y tu llave de API, y con la guía de 5 pasos de la documentación emites tu primera factura de prueba.

¿Gemefact es un software contable?

No. Es la pieza de facturación electrónica dentro del sistema que ya usas: tu ERP, tu tienda en línea o tu software a la medida. Tu sistema envía los datos de la venta y Gemefact se encarga del documento.

¿Puedo emitir muchas facturas a la vez?

Sí. Puedes enviar hasta 100 documentos por petición, o emitir de forma asíncrona, y consultar después el estado de cada uno. Está pensado para facturación masiva y cierres de mes.

¿Qué pasa si la DIAN no responde?

El documento queda pendiente con su número asignado, Gemefact lo reintenta automáticamente y puedes consultar su estado cuando quieras. Si la DIAN lo rechaza, recibes el motivo para corregirlo.

¿Cuánto cuesta?

Depende de tu volumen de documentos. Cuéntanos cuántos emites al mes y te enviamos una propuesta.

¿Qué tan seguros están mis datos y mi certificado?

Tu certificado y su clave se guardan cifrados y no se vuelven a mostrar. Las llaves de API se pueden limitar por red o dejar de solo lectura, y cada empresa ve únicamente su propia información.

Empieza a facturar electrónicamente desde tu sistema

Cuéntanos qué necesitas integrar y cuántos documentos emites al mes. Te creamos tu cuenta y te acompañamos hasta tu primera factura.

[email protected]
Escríbenos