Aurora API
  • Inicio
    • Introducción
    • Suscripción
    • Credenciales API
    • Configuración
    • Sucursales
    • Entidades (Clientes)
    • Pase a producción
  • Documentos
    • Generar comprobantes electrónicos
    • Anular comprobantes electrónicos
    • Códigos de respuesta API HTTP
Powered by GitBook
On this page
  1. Documentos

Generar comprobantes electrónicos

PreviousPase a producciónNextAnular comprobantes electrónicos

Last updated 4 months ago

Generar documento

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

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.

Consultar documento

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

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

Send pending document by ID

get
Authorizations
Path parameters
documentIdstringRequiredExample: 9ddfef6e-1cac-4f07-a8bb-0b522d10bb08
Responses
200
OK
application/json
403
Forbidden
404
Not Found
get
GET /api/v1/documents/{documentId}/send 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_description": "La Factura numero FFF1-20, ha sido aceptada",
  "sunat_note": null,
  "sunat_responsecode": 0,
  "sunat_soap_error": 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"
}

Get document by ID

get
Authorizations
Path parameters
documentIdstringRequiredExample: 9ddfef6e-1cac-4f07-a8bb-0b522d10bb08
Responses
200
OK
application/json
403
Forbidden
404
Not Found
get
GET /api/v1/documents/{documentId} 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_description": "La Factura numero FFF1-20, ha sido aceptada",
  "sunat_note": null,
  "sunat_responsecode": 0,
  "sunat_soap_error": 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"
}
  • Generar documento
  • POSTCreate a document
  • Enviar documento pendiente
  • GETSend pending document by ID
  • Consultar documento
  • GETGet document by ID
  • Ver comprobantes electrónicos emitidos
  • Catálogos para generar comprobantes electrónicos
  • Tabla de tipos comprobantes electrónicos
  • Tabla de tipos de entidad
  • Tabla de tipos de moneda
  • Tabla de tipos de pago
  • Tabla de tipos de IGV

Create a document

post
Authorizations
Body
tipo_de_comprobantestring · enumOptionalExample: 01Possible values:
seriestringOptionalExample: FFF1
numeronumberOptionalExample: 1
cliente_tipo_de_documentostring · enumOptionalExample: 6Possible values:
cliente_numero_de_documentostringOptionalExample: 20603274742
cliente_denominacionstringOptionalExample: EMPRESA DE PRUEBA
cliente_direccionstringOptionalExample: AV. LARCO 123
cliente_emailstringOptional
codigo_sunat_de_sucursalstringOptionalExample: 0000
fecha_de_emisionstringOptionalExample: 02-01-2025
fecha_de_vencimientostring | nullableOptional
monedastring · enumOptionalExample: PENPossible values:
tipo_de_cambiostring | nullableOptional
porcentaje_de_igvnumberOptionalExample: 18
total_gravadanumberOptionalExample: 100
total_inafectanumber | nullableOptional
total_exoneradanumber | nullableOptional
total_gratuitanumber | nullableOptional
total_igvnumberOptionalExample: 18
totalnumberOptionalExample: 118
detraccionbooleanOptionalExample: false
observacionesstring | nullableOptional
documento_que_se_modifica_tipostring | nullableOptional
documento_que_se_modifica_seriestring | nullableOptional
documento_que_se_modifica_numerostring | nullableOptional
tipo_de_nota_de_creditostring | nullableOptional
tipo_de_nota_de_debitostring | nullableOptional
forma_de_pagostringOptionalExample: 1
medio_de_pagostringOptionalExample: CONTADO
orden_compra_serviciostring | nullableOptional
Responses
201
Created
application/json
403
Forbidden
404
Not Found
post
POST /api/v1/documents HTTP/1.1
Host: aurora.net.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1029

{
  "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",
  "orden_compra_servicio": "null",
  "items": [
    {
      "unidad_de_medida": "NIU",
      "codigo": "001",
      "descripcion": "DETALLE DEL PRODUCTO",
      "codigo_producto_sunat": "10000000",
      "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_description": "La Factura numero FFF1-20, ha sido aceptada",
  "sunat_note": null,
  "sunat_responsecode": 0,
  "sunat_soap_error": 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"
}