Skip to main content

Facturación electrónica AFIP

Conceptos Generales​

Zenrise permite facturación electrónica en AFIP por integración mediante API. Para poder facturar es necesario tener una cuenta de AFIP y tener habilitado el servicio de facturación electrónica. Contactate con soporte para que te enviemos el certificado y la guía para que puedas habilitar el servicio.

Configuración​

Existen dos opciones para facturar con nuestra API:

  • Automática: Se realiza la facturación de forma automática con parámetros preestablecidos. Zenrise factura todos los viernes y todos los últimos días del mes. En esta facturación se pueden configurar distintos parámetros para elegir qué comprobantes se facturan y cuáles no:
    • Estado de Invoice en Zenrise: Si se facturan las invoices con estado Pagado o Acreditado.
    • Monto Mínimo: Un umbral (threshold) para facturar invoices con monto mayor a este valor.
    • Fecha Inicial: Desde qué fecha se facturan las invoices.
    • Enviar por email: Si debemos disparar las facturas por email al cliente con copia a la casilla de la organización.
  • Manual: Se realiza la facturación de forma manual por API.

Importante! En el caso de optar por la forma automática, es necesario realizar la configuración inicial con nuestro equipo de soporte. En el caso de optar por la forma manual se pueden usar los endpoints de esta guía.​

Enviar Invoice a Facturar​

La factura debe estar previamente creada con alguno de los métodos que crean facturas, el más común es Request Simple. El campo invoiceId es el que se debe enviar para que Zenrise pueda facturarla. Es muy importante que al crear la factura con request simple se envíen los datos del documento del contacto.

"holderDocumentNumber":"string" "documentType":"string" // CUIT o DNI

URL: /v1/afip/bill

Método: POST

Requiere Auth: Sí, ver Autenticación

Request Payload:

{
        "invoicesId":[1304391,1304385],
        "billDate":"2022-08-30"
}

Detalles importantes del Payload:

invoicesId El o los ids de las invoices que se quieren facturar.

billDate: La fecha de facturación. Si no se envía, se facturará el día de hoy.

Actualizar estado de Invoice​

El proceso de factura electrónica en AFIP es un proceso que puede demorar varios minutos. Por lo tanto, es necesario consultar el estado de la factura para saber si ya fue procesada y se encuentra en estado facturado, o si todavía se encuentra en proceso de facturación.

URL: /v1/afip/billed-invoices/{invoiceId}

Método: GET

Requiere Auth: Sí, ver Autenticación

Request Payload: No aplica

Request Path Variables:

invoiceId: El id de la invoice que se quiere consultar.

Request response

{
    "contactEmail": "test@gmail.com",
    "organizationEmail": "organization@gemail.com",
    "contactFullName": "Juan Perez",
    "organizationName": "Organization SA",
    "invoiceId": 823241,
    "renderUrl": "https://render.zenrise.io/zen/bill-pdf/d/630f9895aeac1c089ab50771",
    "receiptType": "FACTURA_B",
    "amount": 4025.00,
    "id": 14982,
    "date": "2022-08-30",
    "status": "BILLED"
}

Detalles importantes del Response:

contactEmail: El email del contacto de la invoice.

organizationEmail: El email de la organización de la invoice.

contactFullName: El nombre completo del contacto de la invoice.

invoiceId: El id de la invoice.

renderUrl: La url para renderizar la factura. Este es el pdf de la factura AFIP.

receiptType: El tipo de comprobante.

amount: El monto total de la invoice.

id: El id de la factura en AFIP.

date: La fecha de facturación.

status: El estado de la factura. Los estados posibles son:

  • BILLED: La factura fue procesada y se encuentra en AFIP.
  • PENDING: La factura todavía se encuentra en proceso de facturación.
  • ERROR_AFIP_BILLING: Hubo un error al facturar la invoice en AFIP. Se debe consultar el campo error para ver el detalle del error y reintentar facturar la invoice.
  • ERROR_INVOICE_CREATION: Hubo un error al crear la invoice en AFIP. Se debe consultar el campo error para ver el detalle del error y reintentar facturar la invoice.