Generar comprobantes electrónicos

Generar documento

Este método debe ser utilizado para generar un documento y enviarlo a los servidores de SUNAT para su procesamiento.

Create a document

post

Autorizaciones

bearerAuth

AuthorizationstringRequerido

Bearer authentication header of the form Bearer <token>.

Cuerpo

application/json

tipo_de_comprobantestring · enumRequeridoExample: 01Valores posibles:

seriestringRequeridoExample: FFF1

numeronumberRequeridoExample: 1

cliente_tipo_de_documentostring · enumRequeridoExample: 6Valores posibles:

cliente_numero_de_documentostringRequeridoExample: 20603274742

cliente_denominacionstringRequeridoExample: EMPRESA DE PRUEBA

cliente_direccionstringRequeridoExample: AV. LARCO 123

cliente_emailstringOpcional

codigo_sunat_de_sucursalstringRequeridoExample: 0000

fecha_de_emisionstringRequeridoExample: 02-01-2025

fecha_de_vencimientostring · nullableOpcional

monedastring · enumRequeridoExample: PENValores posibles:

tipo_de_cambiostring · nullableOpcional

porcentaje_de_igvnumberRequeridoExample: 18

total_gravadanumberRequeridoExample: 100

total_inafectanumber · nullableOpcional

total_exoneradanumber · nullableOpcional

total_gratuitanumber · nullableOpcional

total_igvnumberRequeridoExample: 18

totalnumberRequeridoExample: 118

detraccionboolean · nullableOpcionalExample: false

observacionesstring · nullableOpcional

documento_que_se_modifica_tipostring · nullableOpcional

documento_que_se_modifica_seriestring · nullableOpcional

documento_que_se_modifica_numerostring · nullableOpcional

tipo_de_nota_de_creditostring · nullableOpcional

tipo_de_nota_de_debitostring · nullableOpcional

forma_de_pagostring · enumRequerido

1 = CONTADO, 2 = CREDITO

Example: 1Valores posibles:

medio_de_pagostring · nullableOpcionalExample: CONTADO

total_impuestos_bolsasnumber · nullableOpcional

orden_compra_serviciostring · nullableOpcional

Respuestas

201

Created

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

post

/documents

HTTPcURLJavaScriptPython

POST /api/v1/documents HTTP/1.1
Host: aurora.net.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1058

{
  "tipo_de_comprobante": "01",
  "serie": "FFF1",
  "numero": 1,
  "cliente_tipo_de_documento": "6",
  "cliente_numero_de_documento": "20603274742",
  "cliente_denominacion": "EMPRESA DE PRUEBA",
  "cliente_direccion": "AV. LARCO 123",
  "codigo_sunat_de_sucursal": "0000",
  "fecha_de_emision": "02-01-2025",
  "fecha_de_vencimiento": null,
  "moneda": "PEN",
  "tipo_de_cambio": null,
  "porcentaje_de_igv": 18,
  "total_gravada": 100,
  "total_inafecta": null,
  "total_exonerada": null,
  "total_gratuita": null,
  "total_igv": 18,
  "total": 118,
  "detraccion": false,
  "observaciones": null,
  "documento_que_se_modifica_tipo": null,
  "documento_que_se_modifica_serie": null,
  "documento_que_se_modifica_numero": null,
  "tipo_de_nota_de_credito": null,
  "tipo_de_nota_de_debito": null,
  "forma_de_pago": "1",
  "medio_de_pago": "CONTADO",
  "total_impuestos_bolsas": null,
  "orden_compra_servicio": null,
  "items": [
    {
      "unidad_de_medida": "NIU",
      "codigo": "001",
      "descripcion": "DETALLE DEL PRODUCTO",
      "codigo_producto_sunat": "10000000",
      "impuesto_bolsas": null,
      "cantidad": 1,
      "valor_unitario": 100,
      "precio_unitario": 118,
      "subtotal": 100,
      "tipo_de_igv": "10",
      "igv": 18,
      "total": 118
    }
  ]
}

{
  "id": "9ddfef6e-1cac-4f07-a8bb-0b522d10bb08",
  "tipo_de_comprobante": "01",
  "serie": "FFF1",
  "numero": 1,
  "aceptada_por_sunat": true,
  "sunat_descripcion": "La Factura numero FFF1-20, ha sido aceptada",
  "sunat_nota": null,
  "sunat_codigo_respuesta": 0,
  "sunat_error_soap": null,
  "anulado": false,
  "cadena_para_codigo_qr": "20000000001|01|FFF1|1|18.00|118.00|02-01-2025|6|20603274742|eYMngApKusm3u6cJTBnvHFwu3z8=|",
  "codigo_hash": "eYMngApKusm3u6cJTBnvHFwu3z8=",
  "enlace_pdf": "https://aurora.net.pe/pdf/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08",
  "enlace_xml": "https://aurora.net.pe/xml/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08",
  "enlace_cdr": "https://aurora.net.pe/cdr/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08"
}

Enviar documento pendiente

Este método debe ser utilizado para enviar un documento previamente generado que no recibió respuesta de los servidores de SUNAT. Esto puede ocurrir debido a problemas de conectividad o mantenimientos programados en los servicios de SUNAT.

Send pending document

get

Autorizaciones

bearerAuth

AuthorizationstringRequerido

Bearer authentication header of the form Bearer <token>.

Parámetros de consulta

tipo_de_comprobantestring · enumRequeridoExample: 01Valores posibles:

seriestringRequeridoExample: FFF1

numeronumberRequeridoExample: 1

Respuestas

200

OK

application/json

idstringOpcionalExample: 9ddfef6e-1cac-4f07-a8bb-0b522d10bb08

tipo_de_comprobantestringOpcionalExample: 01

seriestringOpcionalExample: FFF1

numeronumberOpcionalExample: 1

aceptada_por_sunatbooleanOpcionalExample: true

sunat_descripcionstringOpcionalExample: La Factura numero FFF1-20, ha sido aceptada

sunat_notastring · nullableOpcional

sunat_codigo_respuestastringOpcionalExample: 0

sunat_error_soapstring · nullableOpcional

anuladobooleanOpcionalExample: false

cadena_para_codigo_qrstringOpcionalExample: 20000000001|01|FFF1|1|18.00|118.00|02-01-2025|6|20603274742|eYMngApKusm3u6cJTBnvHFwu3z8=|

codigo_hashstringOpcionalExample: eYMngApKusm3u6cJTBnvHFwu3z8=

enlace_pdfstringOpcionalExample: https://aurora.net.pe/pdf/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08

enlace_xmlstringOpcionalExample: https://aurora.net.pe/xml/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08

enlace_cdrstringOpcionalExample: https://aurora.net.pe/cdr/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

get

/documents/send

HTTPcURLJavaScriptPython

GET /api/v1/documents/send?tipo_de_comprobante=01&serie=text&numero=1 HTTP/1.1
Host: aurora.net.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "9ddfef6e-1cac-4f07-a8bb-0b522d10bb08",
  "tipo_de_comprobante": "01",
  "serie": "FFF1",
  "numero": 1,
  "aceptada_por_sunat": true,
  "sunat_descripcion": "La Factura numero FFF1-20, ha sido aceptada",
  "sunat_nota": null,
  "sunat_codigo_respuesta": 0,
  "sunat_error_soap": null,
  "anulado": false,
  "cadena_para_codigo_qr": "20000000001|01|FFF1|1|18.00|118.00|02-01-2025|6|20603274742|eYMngApKusm3u6cJTBnvHFwu3z8=|",
  "codigo_hash": "eYMngApKusm3u6cJTBnvHFwu3z8=",
  "enlace_pdf": "https://aurora.net.pe/pdf/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08",
  "enlace_xml": "https://aurora.net.pe/xml/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08",
  "enlace_cdr": "https://aurora.net.pe/cdr/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08"
}

Consultar documento

Este método debe ser utilizado para consultar el estado de un documento previamente generado y enviado a los servidores de SUNAT.

Get document

get

Autorizaciones

bearerAuth

AuthorizationstringRequerido

Bearer authentication header of the form Bearer <token>.

Parámetros de consulta

tipo_de_comprobantestring · enumRequeridoExample: 01Valores posibles:

seriestringRequeridoExample: FFF1

numeronumberRequeridoExample: 1

Respuestas

200

OK

application/json

idstringOpcionalExample: 9ddfef6e-1cac-4f07-a8bb-0b522d10bb08

tipo_de_comprobantestringOpcionalExample: 01

seriestringOpcionalExample: FFF1

numeronumberOpcionalExample: 1

aceptada_por_sunatbooleanOpcionalExample: true

sunat_descripcionstringOpcionalExample: La Factura numero FFF1-20, ha sido aceptada

sunat_notastring · nullableOpcional

sunat_codigo_respuestastringOpcionalExample: 0

sunat_error_soapstring · nullableOpcional

anuladobooleanOpcionalExample: false

cadena_para_codigo_qrstringOpcionalExample: 20000000001|01|FFF1|1|18.00|118.00|02-01-2025|6|20603274742|eYMngApKusm3u6cJTBnvHFwu3z8=|

codigo_hashstringOpcionalExample: eYMngApKusm3u6cJTBnvHFwu3z8=

enlace_pdfstringOpcionalExample: https://aurora.net.pe/pdf/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08

enlace_xmlstringOpcionalExample: https://aurora.net.pe/xml/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08

enlace_cdrstringOpcionalExample: https://aurora.net.pe/cdr/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08

403

Forbidden

application/json

404

Not Found

application/json

get

/documents

HTTPcURLJavaScriptPython

GET /api/v1/documents?tipo_de_comprobante=01&serie=text&numero=1 HTTP/1.1
Host: aurora.net.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "9ddfef6e-1cac-4f07-a8bb-0b522d10bb08",
  "tipo_de_comprobante": "01",
  "serie": "FFF1",
  "numero": 1,
  "aceptada_por_sunat": true,
  "sunat_descripcion": "La Factura numero FFF1-20, ha sido aceptada",
  "sunat_nota": null,
  "sunat_codigo_respuesta": 0,
  "sunat_error_soap": null,
  "anulado": false,
  "cadena_para_codigo_qr": "20000000001|01|FFF1|1|18.00|118.00|02-01-2025|6|20603274742|eYMngApKusm3u6cJTBnvHFwu3z8=|",
  "codigo_hash": "eYMngApKusm3u6cJTBnvHFwu3z8=",
  "enlace_pdf": "https://aurora.net.pe/pdf/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08",
  "enlace_xml": "https://aurora.net.pe/xml/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08",
  "enlace_cdr": "https://aurora.net.pe/cdr/9ddfef6e-1cac-4f07-a8bb-0b522d10bb08"
}

Ver comprobantes electrónicos emitidos

Puede buscar y filtrar comprobantes electrónicos por fecha de emision, cliente (denominación o número de documento) y número de documento.

El filtro también permite establecer un rango de fechas.

El botón Opciones permite las siguientes acciones:

• Enviar a SUNAT (cuando estado es pendiente)

• Ver detalle respuesta SUNAT

La opción Exportar genera un archivo Excel con los comprobantes electrónicos emitidos en base a los filtros aplicados.

Catálogos para generar comprobantes electrónicos

Tabla de tipos comprobantes electrónicos

Código	Descripción
01	FACTURA
03	BOLETA DE VENTA
07	NOTA DE CRÉDITO
08	NOTA DE DÉBITO

Tabla de tipos de entidad

Código	Descripción
-	VARIOS
1	DNI
6	RUC
4	CARNET DE EXTRANJERIA
7	PASAPORTE

Tabla de tipos de moneda

Código	Descripción
PEN	SOLES
USD	DÓLARES AMERICANOS

Tabla de tipos de pago

Código	Descripción
1	CONTADO
2	CRÉDITO

Tabla de tipos de IGV

Código	Descripción
10	Gravado - Operación Onerosa
11	Gravado - Retiro por premio
12	Gravado - Retiro por donación
13	Gravado - Retiro
14	Gravado - Retiro por publicidad
15	Gravado - Bonificaciones
16	Gravado - Retiro por entrega a trabajadores
20	Exonerado - Operación Onerosa
21	Exonerado - Transferencia Gratuita
30	Inafecto - Operación Onerosa
31	Inafecto - Retiro por Bonificación
32	Inafecto - Retiro
33	Inafecto - Retiro por Muestras Médicas
34	Inafecto - Retiro por Convenio Colectivo
35	Inafecto - Retiro por premio
36	Inafecto - Retiro por publicidad