Obtener Información

Obtiene los datos estructurados (cabeceras, items, totales) del comprobante electrónico en formato JSON, sin necesidad de parsear el XML.

GET/api/v1/sunat/receptor/info/{document_id}

Parámetros de Ruta

Parámetros

Nombre	Tipo	Descripción
`document_id`requerido	string	Identificador del documento en formato SUNAT: RUC-TIPO-SERIE-NUMERO

Ejemplo de Código

1curl -X GET \
2  "https://api.integracpe.com/api/v1/sunat/receptor/info/20600000001-01-F001-00001234" \
3  -H "Authorization: Bearer sk_live_tu_api_key"

Respuestas

Respuesta Exitosa

200 OK

{
  "success": true,
  "document_id": "20600000001-01-F001-00001234",
  "tipo_documento": "01",
  "tipo_documento_descripcion": "Factura",
  "serie": "F001",
  "numero": "00001234",
  "fecha_emision": "2024-01-15",
  "emisor": {
    "ruc": "20600000001",
    "razon_social": "EMPRESA PROVEEDORA S.A.C.",
    "direccion": "AV. JAVIER PRADO ESTE 1234, SAN ISIDRO, LIMA"
  },
  "receptor": {
    "ruc": "20600000002",
    "razon_social": "MI EMPRESA S.A.C."
  },
  "totales": {
    "moneda": "PEN",
    "subtotal": 1000,
    "igv": 180,
    "total": 1180
  },
  "items": [
    {
      "descripcion": "Servicio de consultoría",
      "cantidad": 1,
      "precio_unitario": 1000,
      "valor_total": 1000
    }
  ]
}

Documento No Encontrado

404 Not Found

{
  "error": {
    "code": "DOCUMENT_NOT_FOUND",
    "message": "El comprobante no existe en SUNAT o no está disponible"
  }
}

Estructura de Respuesta

Campos Principales

Campo	Tipo	Descripción
document_id	string	Identificador completo del documento
tipo_documento	string	Código del tipo (01, 03, 07, 08)
tipo_documento_descripcion	string	Nombre del tipo de documento
serie	string	Serie del comprobante
numero	string	Número correlativo
fecha_emision	string	Fecha en formato YYYY-MM-DD

Objeto `emisor`

Campo	Tipo	Descripción
ruc	string	RUC del emisor/proveedor
razon_social	string	Razón social del emisor
direccion	string	Dirección fiscal del emisor

Objeto `totales`

Campo	Tipo	Descripción
moneda	string	Código de moneda (PEN, USD)
subtotal	number	Valor de venta (sin IGV)
igv	number	Monto del IGV
total	number	Importe total a pagar

Array `items[]`

Campo	Tipo	Descripción
descripcion	string	Descripción del producto/servicio
cantidad	number	Cantidad vendida
precio_unitario	number	Precio por unidad
valor_total	number	Valor total de la línea

Sin parseo de XML

Este endpoint parsea el XML por ti y devuelve los datos estructurados en JSON. Ideal para integraciones donde solo necesitas los datos del comprobante sin el archivo original.

Campos adicionales

La respuesta puede incluir campos adicionales según el tipo de documento (notas de crédito/débito incluyen referencia al documento afectado, etc.).

Descargar PDF Consulta CPE