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

POSThttps://aurora.net.pe/api/v1/documents

Authorization

Body

tipo_de_comprobanteenum

Example: "01"

01030708

seriestring

Example: "FFF1"

numeronumber

Example: 1

cliente_tipo_de_documentoenum

Example: "6"

-1647

cliente_numero_de_documentostring

Example: "20603274742"

cliente_denominacionstring

Example: "EMPRESA DE PRUEBA"

cliente_direccionstring

Example: "AV. LARCO 123"

cliente_emailstring

codigo_sunat_de_sucursalstring

Example: "0000"

fecha_de_emisionstring

Example: "02-01-2025"

fecha_de_vencimientonullable string

monedaenum

Example: "PEN"

PENUSD

tipo_de_cambionullable string

porcentaje_de_igvnumber

Example: 18

total_gravadanumber

Example: 100

total_inafectanullable number

total_exoneradanullable number

total_gratuitanullable number

total_igvnumber

Example: 18

totalnumber

Example: 118

detraccionboolean

Example: false

observacionesnullable string

documento_que_se_modifica_tiponullable string

documento_que_se_modifica_serienullable string

documento_que_se_modifica_numeronullable string

tipo_de_nota_de_creditonullable string

tipo_de_nota_de_debitonullable string

forma_de_pagostring

Example: "1"

medio_de_pagostring

Example: "CONTADO"

orden_compra_servicionullable string

itemsarray of DocumentItem (object)

Response

Created

Body

idstring

Example: "9ddfef6e-1cac-4f07-a8bb-0b522d10bb08"

tipo_de_comprobantestring

Example: "01"

seriestring

Example: "FFF1"

numeronumber

Example: 1

aceptada_por_sunatboolean

Example: true

sunat_descriptionstring

Example: "La Factura numero FFF1-20, ha sido aceptada"

sunat_notenullable string

sunat_responsecodestring

Example: 0

sunat_soap_errornullable string

anuladoboolean

Example: false

cadena_para_codigo_qrstring

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

codigo_hashstring

Example: "eYMngApKusm3u6cJTBnvHFwu3z8="

enlace_pdfstring

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

enlace_xmlstring

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

enlace_cdrstring

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

Request

const response = await fetch('https://aurora.net.pe/api/v1/documents', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "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
        }
      ]
    }),
});
const data = await response.json();

Response

{
  "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"
}

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 by ID

GEThttps://aurora.net.pe/api/v1/documents/{documentId}/send

Authorization

Path parameters

documentId*string

Example: "9ddfef6e-1cac-4f07-a8bb-0b522d10bb08"

Response

Body

idstring

Example: "9ddfef6e-1cac-4f07-a8bb-0b522d10bb08"

tipo_de_comprobantestring

Example: "01"

seriestring

Example: "FFF1"

numeronumber

Example: 1

aceptada_por_sunatboolean

Example: true

sunat_descriptionstring

Example: "La Factura numero FFF1-20, ha sido aceptada"

sunat_notenullable string

sunat_responsecodestring

Example: 0

sunat_soap_errornullable string

anuladoboolean

Example: false

cadena_para_codigo_qrstring

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

codigo_hashstring

Example: "eYMngApKusm3u6cJTBnvHFwu3z8="

enlace_pdfstring

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

enlace_xmlstring

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

enlace_cdrstring

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

Request

const response = await fetch('https://aurora.net.pe/api/v1/documents/{documentId}/send', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

{
  "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"
}

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 by ID

GEThttps://aurora.net.pe/api/v1/documents/{documentId}

Authorization

Path parameters

documentId*string

Example: "9ddfef6e-1cac-4f07-a8bb-0b522d10bb08"

Response

Body

idstring

Example: "9ddfef6e-1cac-4f07-a8bb-0b522d10bb08"

tipo_de_comprobantestring

Example: "01"

seriestring

Example: "FFF1"

numeronumber

Example: 1

aceptada_por_sunatboolean

Example: true

sunat_descriptionstring

Example: "La Factura numero FFF1-20, ha sido aceptada"

sunat_notenullable string

sunat_responsecodestring

Example: 0

sunat_soap_errornullable string

anuladoboolean

Example: false

cadena_para_codigo_qrstring

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

codigo_hashstring

Example: "eYMngApKusm3u6cJTBnvHFwu3z8="

enlace_pdfstring

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

enlace_xmlstring

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

enlace_cdrstring

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

Request

const response = await fetch('https://aurora.net.pe/api/v1/documents/{documentId}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

{
  "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"
}

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

FACTURA

BOLETA DE VENTA

NOTA DE CRÉDITO

NOTA DE DÉBITO

Tabla de tipos de entidad

Código

Descripción

VARIOS

DNI

RUC

CARNET DE EXTRANJERIA

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

CONTADO

CRÉDITO

Tabla de tipos de IGV

Código

Descripción

Gravado - Operación Onerosa

Gravado - Retiro por premio

Gravado - Retiro por donación

Gravado - Retiro

Gravado - Retiro por publicidad

Gravado - Bonificaciones

Gravado - Retiro por entrega a trabajadores

Exonerado - Operación Onerosa

Exonerado - Transferencia Gratuita

Inafecto - Operación Onerosa

Inafecto - Retiro por Bonificación

Inafecto - Retiro

Inafecto - Retiro por Muestras Médicas

Inafecto - Retiro por Convenio Colectivo

Inafecto - Retiro por premio

Inafecto - Retiro por publicidad

PreviousPase a producción NextAnular comprobantes electrónicos

Last updated 15 days ago