Facturación electrónica AFIP

Conceptos Generales

Zenrise permite facturacion electronica 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 guia para que puedas habilitar el servicio.

Configuración

Existen dos opciones para facturar con nuestra API:

  • Automatica: Se realiza la facturación de forma automática con parametros pre establecidos. Zenrise factura todos los viernes y todos los ultimos días del mes. En esta facturacion se pueden configurar distintos parametros para elegir que comprobantes se facuran y cuales no:
    • Estado de Inovoice en Zenrise: Si se facturan las invoices con estado Pagado o Acreditado.
    • Monto Minimo: Algun treshold para facturar invoices con monto mayor a este valor.
    • Fecha Inicial: Desde que 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 automatica, 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 guia.

Enviar Invoice a Facturar

La factura debe estar previamente creada con algunos de los metodos que crean facturas, el mas comun 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 envien los datos del documento del contacto.

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

URL: /v1/afip/bill

Metodo: POST

Requiere Auth: Si, ver Autenticación

Request Payload:

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

Detalle importantes del Payload:

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

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

Actualizar estado de Invoice

El proceso de factura electronica 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 ya se encuentra en estado facturado o si todavía se encuentra en proceso de facturación.

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

Metodo: GET

Requiere Auth: Si, 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"
}

Detalle 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 re intentar 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 re intentar facturar la invoice.