SmartClic
API v2.0 · Producción

Integra SmartClic con tu operación.

Referencia técnica para emitir comprobantes y guías, consultar documentos y descargar archivos electrónicos mediante JSON.

Comenzar la integración Ver endpoints

Base URL

https://erpperuapi.smartclic.pe

Formato

application/json

Manual

05/08/2024

Inicio rápido

Tu primera solicitud en cuatro decisiones.

01

Obtén tu credencial

Solicita la API key habilitada para tu empresa y consérvala solo en el servidor.

02

Elige la operación

Emite, consulta o descarga usando el endpoint específico de esta referencia.

03

Envía JSON

Agrega Authorization y Content-Type en cada solicitud autenticada.

04

Valida la respuesta

Guarda el identificador recibido y procesa los errores por código, campo y línea.

Antes de producción: valida la serie, la numeración, los dominios y los totales tributarios con la configuración asignada a tu empresa.

Autenticación

Plataforma web e integración API.

El uso del sistema se puede realizar de dos maneras: por la interfaz web o por la integración con la API. Para la integración, el manual indica el header Authorization con autenticación Basic.

Protege las credenciales de producción.

Conserva las credenciales fuera del navegador y del repositorio. Los valores visibles en esta documentación corresponden exactamente al entorno de prueba publicado en el manual.

cURL
curl --request POST \
  --url https://erpperuapi.smartclic.pe/Contabilidad/api/v1/masivos/documento/dto \
  --header 'Authorization: Basic VnFky1qddW6Xr81wPYxV7+mgJS/DFwYY' \
  --header 'Content-Type: application/json' \
  --data '[{ "Serie": "F801", "Correlativo": "17" }]'

Entorno de prueba

Credenciales de acceso al entorno de prueba.

Estas credenciales corresponden al entorno de prueba de SmartClic. Úsalas para acceder a la plataforma web y autenticar las solicitudes de integración con la API.

Credenciales para la plataforma web

https://erpperu.smartclic.pe/auth/login
username
demo-api
password
4TqbZt9A

Credenciales API Key · Request Header

Key
Authorization
Value
Basic VnFky1qddW6Xr81wPYxV7+mgJS/DFwYY

Comprobantes electrónicos

API para emisión de Factura/Boleta

Esta API sirve para emitir los documentos contables Factura y Boleta, los cuales pueden registrar la venta de uno o más ítems (productos). Las facturas se utilizan solo para clientes que ingresen su RUC y las boletas pueden utilizarse para clientes con diversos tipos de documentos de identificación como el DNI, RUC, etc.

POSThttps://erpperuapi.smartclic.pe/Contabilidad/api/v1/masivos/documento/dto

Los resultados del uso de esta API se pueden observar en la página web del sistema. El manual enlaza el video de capacitación de búsqueda de documentos. Ver capacitación

III. Datos de entrada de la API

Parámetros de entrada

Documento
  • SerieSí
    Tipo
    Texto
    Longitud
    4

    Serie; debe ser una serie manual.

  • CorrelativoSí
    Tipo
    Numérico
    Longitud
    8

    Correlativo; debe ser único.

  • FechaEmisionSí
    Tipo
    Texto
    Longitud
    10

    Fecha de emisión. No puede exceder en 7 días. Formato: aaaa-mm-dd.

  • FechaVencimientoNo
    Tipo
    Texto
    Longitud
    10

    Si no se coloca, la fecha de vencimiento es determinada por la fecha de emisión. Formato: aaaa-mm-dd.

  • MonedaSí
    Tipo
    Texto
    Longitud
    3

    Tipo de moneda: PEN (Soles) o USD (Dólares).

  • CondicionPagoSí
    Tipo
    Numérico
    Longitud
    1

    Condición de pago: 1 Contado; 2 Crédito.

  • CuotasCondicional
    Tipo
    Texto | Numérico
    Longitud
    —

    Obligatorio cuando CondicionPago es 2 (Crédito). Usa Fecha|Monto y separa las cuotas por coma. Ejemplo: 2022-04-15|25.00,2022-05-15|30.00.

Receptor
  • ReceptorTipoDocumentoSí
    Tipo
    Texto
    Longitud
    19

    Tipo de documento del receptor: DNI, RUC, PASAPORTE o CARNETDEEXTRANJERIA.

  • ReceptorNumeroDocumentoSí
    Tipo
    Texto
    Longitud
    —

    Número de documento del receptor.

  • NombreReceptorSí
    Tipo
    Texto
    Longitud
    —

    Nombre del receptor.

  • CorreoNo
    Tipo
    Texto
    Longitud
    —

    Correo del receptor.

  • DireccionReceptorNo
    Tipo
    Texto
    Longitud
    —

    Dirección del receptor.

  • ObservacionNo
    Tipo
    Texto
    Longitud
    Máx. 200

    Observación.

Totales
  • OperacionesGravadasSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de operaciones gravadas. Ejemplo: 34.45. Si no tiene valor, colocar 0.00.

  • OperacionesInafectasSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de operaciones inafectas.

  • OperacionesExoneradasSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de operaciones exoneradas.

  • OperacionesGratuitasSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de operaciones gratuitas.

  • OperacionesExportadasCondicional
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de operaciones exportadas; es obligatorio si existen operaciones exportadas.

  • TotalDescuentosPorItemSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Sumatoria de descuentos por ítem.

  • TotalOtrosCargosSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de otros cargos.

  • TotalIgvSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de IGV.

  • TotalOtrosTributosSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de otros tributos.

  • TotalPrecioVentaSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total del precio de venta, incluido IGV.

  • SubTotalSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Subtotal de la venta.

  • ImporteTotalSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Importe total de la venta.

DetracciónCompleta estos campos solo cuando la operación esté sujeta a detracción.
  • DetraccionNo
    Tipo
    Texto
    Longitud
    —

    Uso de detracciones: true o false.

  • DetraccionPorcentajeCondicional
    Tipo
    Numérico
    Longitud
    —

    Porcentaje de detracción. Obligatorio si Detraccion es true. Sin decimales.

  • DetraccionCodigoMedioPagoCondicional
    Tipo
    Numérico
    Longitud
    —

    Código del medio de pago según SUNAT. Obligatorio si Detraccion es true. Ver Detracción Medios Pago.

  • DetraccionNrocuentaCondicional
    Tipo
    Texto
    Longitud
    —

    Número de cuenta para detracciones. Obligatorio si Detraccion es true.

  • DetraccionCodigoBienServicioCondicional
    Tipo
    Numérico
    Longitud
    —

    Código del bien o servicio. Obligatorio si Detraccion es true. Ver Detracción Bien Servicio.

ÍtemAñade un objeto por ítem y conserva la misma serie y correlativo para agruparlos en un comprobante.
  • NroOrdenItemSí
    Tipo
    Numérico
    Longitud
    —

    Número de orden del ítem.

  • UnidadMedidaSí
    Tipo
    Texto
    Longitud
    Máx. 5

    Unidad de medida del ítem. Ver Tipos de unidad de medida.

  • CantidadSí
    Tipo
    Numérico
    Longitud
    —

    Cantidad por ítem.

  • CodigoProductoSí
    Tipo
    Texto
    Longitud
    Máx. 10

    Código del producto.

  • DescripcionProductoSí
    Tipo
    Texto
    Longitud
    Máx. 500

    Descripción del producto o servicio.

  • ValorUnitarioSí
    Tipo
    Numérico, 2 a 8 decimales
    Longitud
    —

    Valor unitario del ítem, sin IGV.

  • PrecioUnitarioSí
    Tipo
    Numérico, 2 a 8 decimales
    Longitud
    —

    Precio unitario del ítem, con IGV.

  • DescuentoPorItemSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Descuento por ítem.

  • IgvSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    IGV por ítem.

  • TipoIgvSí
    Tipo
    Numérico
    Longitud
    2

    Código de tipo de afectación de IGV. Ver Tipos de Afectación IGV.

  • TipoIgvDescripcionSí
    Tipo
    Texto
    Longitud
    —

    Descripción de tipo de afectación de IGV. Ver Tipos de Afectación IGV.

  • ValorDeVentaSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Valor de venta del ítem: ValorUnitario × Cantidad.

  • PrecioDeVentaSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Precio de venta del ítem: PrecioUnitario × Cantidad, incluido IGV.

  • TotalDetalleSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total del detalle.

  • Auxiliar1Sí
    Tipo
    Numérico
    Longitud
    1

    Siempre con el valor 0.

IV. Tramas de ejemplo de datos de entrada

Ejemplos de entrada

1. Factura 2 ítems gravados al contadoVer trama
Body JSON
[
  {
    "Serie": "F801",
    "Correlativo": "17",
    "FechaEmision": "2024-08-07",
    "Moneda": "PEN",
    "CondicionPago": "1",
    "ReceptorTipoDocumento": "RUC",
    "ReceptorNumeroDocumento": "10434365533",
    "NombreReceptor": "ROSADO ROLDAN LUIS FERNANDO",
    "Correo": "",
    "DireccionReceptor": "Av. El sol 105 - Paucarpata",
    "Observacion": "Ninguna",
    "OperacionesGravadas": 63.56,
    "OperacionesInafectas": 0.0,
    "OperacionesExoneradas": 0.0,
    "OperacionesGratuitas": 0.0,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 11.44,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 75.0,
    "SubTotal": 63.56,
    "ImporteTotal": 75.0,
    "NroOrdenItem": "1",
    "UnidadMedida": "NIU",
    "Cantidad": 1,
    "CodigoProducto": "F99988",
    "DescripcionProducto": "1709 BIEN GR",
    "ValorUnitario": 25.42,
    "PrecioUnitario": 30.0,
    "DescuentoPorItem": 0.0,
    "Igv": 4.58,
    "TipoIgv": "10",
    "TipoIgvDescripcion": "Gravado",
    "ValorDeVenta": 25.42,
    "PrecioDeVenta": 30.0,
    "TotalDetalle": 30.0,
    "Auxiliar1": "0"
  },
  {
    "Serie": "F801",
    "Correlativo": "17",
    "FechaEmision": "2024-08-07",
    "Moneda": "PEN",
    "CondicionPago": "1",
    "ReceptorTipoDocumento": "RUC",
    "ReceptorNumeroDocumento": "10434365533",
    "NombreReceptor": "ROSADO ROLDAN LUIS FERNANDO",
    "Correo": "",
    "DireccionReceptor": "Av. El sol 105 - Paucarpata",
    "Observacion": "Ninguna",
    "OperacionesGravadas": 63.56,
    "OperacionesInafectas": 0.0,
    "OperacionesExoneradas": 0.0,
    "OperacionesGratuitas": 0.0,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 11.44,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 75.0,
    "SubTotal": 63.56,
    "ImporteTotal": 75.0,
    "NroOrdenItem": "2",
    "UnidadMedida": "NIU",
    "Cantidad": 1,
    "CodigoProducto": "B600161971",
    "DescripcionProducto": "1709 BIEN GR 2",
    "ValorUnitario": 38.14,
    "PrecioUnitario": 45.0,
    "DescuentoPorItem": 0.0,
    "Igv": 6.86,
    "TipoIgv": "10",
    "TipoIgvDescripcion": "Gravado",
    "ValorDeVenta": 38.14,
    "PrecioDeVenta": 45.0,
    "TotalDetalle": 45.0,
    "Auxiliar1": "0"
  }
]
2. Factura 2 ítems gravados al crédito, 3 cuotasVer trama
Body JSON
[
  {
    "Serie": "F801",
    "Correlativo": "18",
    "FechaEmision": "2024-08-07",
    "FechaVencimiento": "2024-11-07",
    "Moneda": "PEN",
    "CondicionPago": "2",
    "Cuotas": "2024-09-07|25.00,2024-10-07|25.00,2024-11-07|25.00",
    "ReceptorTipoDocumento": "RUC",
    "ReceptorNumeroDocumento": "10434365533",
    "NombreReceptor": "ROSADO ROLDAN LUIS FERNANDO",
    "Correo": "",
    "DireccionReceptor": "Av. El sol 105 - Paucarpata",
    "Observacion": "Ninguna",
    "OperacionesGravadas": 63.56,
    "OperacionesInafectas": 0.0,
    "OperacionesExoneradas": 0.0,
    "OperacionesGratuitas": 0.0,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 11.44,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 75.0,
    "SubTotal": 63.56,
    "ImporteTotal": 75.0,
    "NroOrdenItem": "1",
    "UnidadMedida": "NIU",
    "Cantidad": 1,
    "CodigoProducto": "F99988",
    "DescripcionProducto": "1709 BIEN GR",
    "ValorUnitario": 25.42,
    "PrecioUnitario": 30.0,
    "DescuentoPorItem": 0.0,
    "Igv": 4.58,
    "TipoIgv": "10",
    "TipoIgvDescripcion": "Gravado",
    "ValorDeVenta": 25.42,
    "PrecioDeVenta": 30.0,
    "TotalDetalle": 30.0,
    "Auxiliar1": "0"
  },
  {
    "Serie": "F801",
    "Correlativo": "18",
    "FechaEmision": "2024-08-07",
    "FechaVencimiento": "2024-11-07",
    "Moneda": "PEN",
    "CondicionPago": "2",
    "Cuotas": "2024-09-07|25.00,2024-10-07|25.00,2024-11-07|25.00",
    "ReceptorTipoDocumento": "RUC",
    "ReceptorNumeroDocumento": "10434365533",
    "NombreReceptor": "ROSADO ROLDAN LUIS FERNANDO",
    "Correo": "",
    "DireccionReceptor": "Av. El sol 105 - Paucarpata",
    "Observacion": "Ninguna",
    "OperacionesGravadas": 63.56,
    "OperacionesInafectas": 0.0,
    "OperacionesExoneradas": 0.0,
    "OperacionesGratuitas": 0.0,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 11.44,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 75.0,
    "SubTotal": 63.56,
    "ImporteTotal": 75.0,
    "NroOrdenItem": "2",
    "UnidadMedida": "NIU",
    "Cantidad": 1,
    "CodigoProducto": "B600161971",
    "DescripcionProducto": "1709 BIEN GR 2",
    "ValorUnitario": 38.14,
    "PrecioUnitario": 45.0,
    "DescuentoPorItem": 0.0,
    "Igv": 6.86,
    "TipoIgv": "10",
    "TipoIgvDescripcion": "Gravado",
    "ValorDeVenta": 38.14,
    "PrecioDeVenta": 45.0,
    "TotalDetalle": 45.0,
    "Auxiliar1": "0"
  }
]
3. Factura 2 ítems de exportación al contadoVer trama
Body JSON
[
  {
    "Serie": "F801",
    "Correlativo": "19",
    "FechaEmision": "2024-08-07",
    "Moneda": "PEN",
    "CondicionPago": "1",
    "ReceptorTipoDocumento": "CARNETDEEXTRANJERIA",
    "ReceptorNumeroDocumento": "A10434365533",
    "NombreReceptor": "ROSADO ROLDAN LUIS FERNANDO",
    "Correo": "",
    "DireccionReceptor": "Av. El sol 105 - Paucarpata",
    "Observacion": "Ninguna",
    "OperacionesGravadas": 0.0,
    "OperacionesInafectas": 0.0,
    "OperacionesExoneradas": 0.0,
    "OperacionesGratuitas": 0.0,
    "OperacionesExportadas": 40.6,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 0.0,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 40.6,
    "SubTotal": 40.6,
    "ImporteTotal": 40.6,
    "NroOrdenItem": "1",
    "UnidadMedida": "NIU",
    "Cantidad": 1,
    "CodigoProducto": "F99988",
    "DescripcionProducto": "1709 BIEN GR",
    "ValorUnitario": 16.4,
    "PrecioUnitario": 16.4,
    "DescuentoPorItem": 0.0,
    "Igv": 0.0,
    "TipoIgv": "40",
    "TipoIgvDescripcion": "Exportación",
    "ValorDeVenta": 16.4,
    "PrecioDeVenta": 16.4,
    "TotalDetalle": 16.4,
    "Auxiliar1": "0"
  },
  {
    "Serie": "F801",
    "Correlativo": "19",
    "FechaEmision": "2024-08-07",
    "Moneda": "PEN",
    "CondicionPago": "1",
    "ReceptorTipoDocumento": "CARNETDEEXTRANJERIA",
    "ReceptorNumeroDocumento": "A10434365533",
    "NombreReceptor": "ROSADO ROLDAN LUIS FERNANDO",
    "Correo": "",
    "DireccionReceptor": "Av. El sol 105 - Paucarpata",
    "Observacion": "Ninguna",
    "OperacionesGravadas": 0.0,
    "OperacionesInafectas": 0.0,
    "OperacionesExoneradas": 0.0,
    "OperacionesGratuitas": 0.0,
    "OperacionesExportadas": 40.6,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 0.0,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 40.6,
    "SubTotal": 40.6,
    "ImporteTotal": 40.6,
    "NroOrdenItem": "2",
    "UnidadMedida": "NIU",
    "Cantidad": 2,
    "CodigoProducto": "B600161971",
    "DescripcionProducto": "1709 BIEN PARA EXPORTACION",
    "ValorUnitario": 12.1,
    "PrecioUnitario": 12.1,
    "DescuentoPorItem": 0.0,
    "Igv": 0.0,
    "TipoIgv": "40",
    "TipoIgvDescripcion": "Exportacion",
    "ValorDeVenta": 24.2,
    "PrecioDeVenta": 24.2,
    "TotalDetalle": 24.2,
    "Auxiliar1": "0"
  }
]
4. Factura 1 ítem gravado al contado con detracciónVer trama
Body JSON
[
  {
    "Serie": "F801",
    "Correlativo": "20",
    "FechaEmision": "2024-08-07",
    "Moneda": "PEN",
    "CondicionPago": "1",
    "Detraccion": "true",
    "DetraccionPorcentaje": 15,
    "DetraccionCodigoMedioPago": "009",
    "DetraccionNrocuenta": "00-058-252514",
    "DetraccionCodigoBienServicio": "022",
    "ReceptorTipoDocumento": "RUC",
    "ReceptorNumeroDocumento": "10434365533",
    "NombreReceptor": "ROSADO ROLDAN LUIS FERNANDO",
    "Correo": "",
    "DireccionReceptor": "Av. El sol 105 - Paucarpata",
    "Observacion": "",
    "OperacionesGravadas": 42.37,
    "OperacionesInafectas": 0.0,
    "OperacionesExoneradas": 0.0,
    "OperacionesGratuitas": 0.0,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 7.63,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 50.0,
    "SubTotal": 42.37,
    "ImporteTotal": 50.0,
    "NroOrdenItem": "1",
    "UnidadMedida": "NIU",
    "Cantidad": 1,
    "CodigoProducto": "P001",
    "DescripcionProducto": "Producto 1",
    "ValorUnitario": 42.37,
    "PrecioUnitario": 50.0,
    "DescuentoPorItem": 0.0,
    "Igv": 7.63,
    "TipoIgv": "10",
    "TipoIgvDescripcion": "Gravado",
    "ValorDeVenta": 42.37,
    "PrecioDeVenta": 50.0,
    "TotalDetalle": 50.0,
    "Auxiliar1": "0"
  }
]
5. Factura 3 ítems: gravado, exonerado e inafecto al contadoVer trama
Body JSON
[
  {
    "Serie": "F801",
    "Correlativo": "21",
    "FechaEmision": "2024-08-07",
    "Moneda": "PEN",
    "CondicionPago": "1",
    "ReceptorTipoDocumento": "RUC",
    "ReceptorNumeroDocumento": "10441910733",
    "NombreReceptor": "ARROSPIDE CHIRINOS MANUEL",
    "Correo": "marrospidec.smartreasons@gmail.com",
    "DireccionReceptor": "Mi casa",
    "Observacion": "",
    "OperacionesGravadas": 33.9,
    "OperacionesInafectas": 60.0,
    "OperacionesExoneradas": 105.0,
    "OperacionesGratuitas": 0.0,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 6.1,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 205.0,
    "SubTotal": 198.9,
    "ImporteTotal": 205.0,
    "NroOrdenItem": "1",
    "UnidadMedida": "KGM",
    "Cantidad": "1",
    "CodigoProducto": "B600162323",
    "DescripcionProducto": "0407 BIEN PUG CF B",
    "ValorUnitario": 33.9,
    "PrecioUnitario": 40.0,
    "DescuentoPorItem": 0.0,
    "Igv": 6.1,
    "TipoIgv": "10",
    "TipoIgvDescripcion": "Gravado - Operacion Onerosa",
    "ValorDeVenta": 33.9,
    "PrecioDeVenta": 40.0,
    "TotalDetalle": 40.0,
    "Auxiliar1": "0"
  },
  {
    "Serie": "F801",
    "Correlativo": "21",
    "FechaEmision": "2024-08-07",
    "Moneda": "PEN",
    "CondicionPago": "1",
    "ReceptorTipoDocumento": "RUC",
    "ReceptorNumeroDocumento": "10441910733",
    "NombreReceptor": "ARROSPIDE CHIRINOS MANUEL",
    "Correo": "marrospidec.smartreasons@gmail.com",
    "DireccionReceptor": "Mi casa",
    "Observacion": "",
    "OperacionesGravadas": 33.9,
    "OperacionesInafectas": 60.0,
    "OperacionesExoneradas": 105.0,
    "OperacionesGratuitas": 0.0,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 6.1,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 205.0,
    "SubTotal": 198.9,
    "ImporteTotal": 205.0,
    "NroOrdenItem": "2",
    "UnidadMedida": "KGM",
    "Cantidad": "2",
    "CodigoProducto": "B6001622",
    "DescripcionProducto": "0407 BIEN PUI CEL A",
    "ValorUnitario": 30.0,
    "PrecioUnitario": 30.0,
    "DescuentoPorItem": 0.0,
    "Igv": 0.0,
    "TipoIgv": "30",
    "TipoIgvDescripcion": "Inafecto - Operacion Onerosa",
    "ValorDeVenta": 60.0,
    "PrecioDeVenta": 60.0,
    "TotalDetalle": 60.0,
    "Auxiliar1": "0"
  },
  {
    "Serie": "F801",
    "Correlativo": "21",
    "FechaEmision": "2024-08-07",
    "Moneda": "PEN",
    "CondicionPago": "1",
    "ReceptorTipoDocumento": "RUC",
    "ReceptorNumeroDocumento": "10441910733",
    "NombreReceptor": "ARROSPIDE CHIRINOS MANUEL",
    "Correo": "marrospidec.smartreasons@gmail.com",
    "DireccionReceptor": "Mi casa",
    "Observacion": "",
    "OperacionesGravadas": 33.9,
    "OperacionesInafectas": 60.0,
    "OperacionesExoneradas": 105.0,
    "OperacionesGratuitas": 0.0,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 6.1,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 205.0,
    "SubTotal": 198.9,
    "ImporteTotal": 205.0,
    "NroOrdenItem": "3",
    "UnidadMedida": "KGM",
    "Cantidad": "3",
    "CodigoProducto": "B6001620",
    "DescripcionProducto": "0406 BIEN PUE CF B",
    "ValorUnitario": 35.0,
    "PrecioUnitario": 35.0,
    "DescuentoPorItem": 0.0,
    "Igv": 0.0,
    "TipoIgv": "20",
    "TipoIgvDescripcion": "Exonerado - Operacion Onerosa",
    "ValorDeVenta": 105.0,
    "PrecioDeVenta": 105.0,
    "TotalDetalle": 105.0,
    "Auxiliar1": "0"
  }
]
6. Boleta simple: 2 ítems gravados con receptorVer trama
Body JSON
[
  {
    "Serie": "B801",
    "Correlativo": "9",
    "FechaEmision": "2024-08-07",
    "Moneda": "PEN",
    "CondicionPago": "1",
    "ReceptorTipoDocumento": "RUC",
    "ReceptorNumeroDocumento": "10441910733",
    "NombreReceptor": "ARROSPIDE CHIRINOS MANUEL",
    "Correo": "marrospidec.smartreasons@gmail.com",
    "DireccionReceptor": "Mi casa",
    "Observacion": "",
    "OperacionesGravadas": 305.1,
    "OperacionesInafectas": 0.0,
    "OperacionesExoneradas": 0.0,
    "OperacionesGratuitas": 0.0,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 54.9,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 360.0,
    "SubTotal": 305.1,
    "ImporteTotal": 360.0,
    "NroOrdenItem": "1",
    "UnidadMedida": "LTR",
    "Cantidad": "1",
    "CodigoProducto": "B600162262",
    "DescripcionProducto": "0303 BIEN PUG CF B ACTUA",
    "ValorUnitario": 50.85,
    "PrecioUnitario": 60.0,
    "DescuentoPorItem": 0.0,
    "Igv": 9.15,
    "TipoIgv": "10",
    "TipoIgvDescripcion": "Gravado - Operacion Onerosa",
    "ValorDeVenta": 50.85,
    "PrecioDeVenta": 60.0,
    "TotalDetalle": 60.0,
    "Auxiliar1": "0"
  },
  {
    "Serie": "B801",
    "Correlativo": "9",
    "FechaEmision": "2024-08-07",
    "Moneda": "PEN",
    "CondicionPago": "1",
    "ReceptorTipoDocumento": "RUC",
    "ReceptorNumeroDocumento": "10441910733",
    "NombreReceptor": "ARROSPIDE CHIRINOS MANUEL",
    "Correo": "marrospidec.smartreasons@gmail.com",
    "DireccionReceptor": "Mi casa",
    "Observacion": "",
    "OperacionesGravadas": 305.1,
    "OperacionesInafectas": 0.0,
    "OperacionesExoneradas": 0.0,
    "OperacionesGratuitas": 0.0,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 54.9,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 360.0,
    "SubTotal": 305.1,
    "ImporteTotal": 360.0,
    "NroOrdenItem": "2",
    "UnidadMedida": "MTR",
    "Cantidad": "3",
    "CodigoProducto": "MAOCB2022",
    "DescripcionProducto": "2801 BIEN PUG CF Z",
    "ValorUnitario": 84.75,
    "PrecioUnitario": 100.0,
    "DescuentoPorItem": 0.0,
    "Igv": 45.75,
    "TipoIgv": "10",
    "TipoIgvDescripcion": "Gravado - Operacion Onerosa",
    "ValorDeVenta": 254.25,
    "PrecioDeVenta": 300.0,
    "TotalDetalle": 300.0,
    "Auxiliar1": "0"
  }
]
7. Boleta 2 ítems inafectos al contadoVer trama
Body JSON
[
  {
    "Serie": "B801",
    "Correlativo": "10",
    "FechaEmision": "2024-08-07",
    "Moneda": "PEN",
    "CondicionPago": "1",
    "ReceptorTipoDocumento": "DNI",
    "ReceptorNumeroDocumento": "43436553",
    "NombreReceptor": "ROSADO ROLDAN LUIS FERNANDO",
    "Correo": "",
    "DireccionReceptor": "Av. El Sol 105 - Paucarpata",
    "Observacion": "Ninguna",
    "OperacionesGravadas": 0.0,
    "OperacionesInafectas": 121.0,
    "OperacionesExoneradas": 0.0,
    "OperacionesGratuitas": 0.0,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 0.0,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 121.0,
    "SubTotal": 121.0,
    "ImporteTotal": 121.0,
    "NroOrdenItem": "1",
    "UnidadMedida": "NIU",
    "Cantidad": 1,
    "CodigoProducto": "F99988",
    "DescripcionProducto": "1709 BIEN GR",
    "ValorUnitario": 50.0,
    "PrecioUnitario": 50.0,
    "DescuentoPorItem": 0.0,
    "Igv": 0.0,
    "TipoIgv": "30",
    "TipoIgvDescripcion": "Inafecto - Operacion Onerosa",
    "ValorDeVenta": 50.0,
    "PrecioDeVenta": 50.0,
    "TotalDetalle": 50.0,
    "Auxiliar1": "0"
  },
  {
    "Serie": "B801",
    "Correlativo": "10",
    "FechaEmision": "2024-08-07",
    "Moneda": "PEN",
    "CondicionPago": "1",
    "ReceptorTipoDocumento": "DNI",
    "ReceptorNumeroDocumento": "43436553",
    "NombreReceptor": "ROSADO ROLDAN LUIS FERNANDO",
    "Correo": "",
    "DireccionReceptor": "Av. El Sol 105 - Paucarpata",
    "Observacion": "Ninguna",
    "OperacionesGravadas": 0.0,
    "OperacionesInafectas": 121.0,
    "OperacionesExoneradas": 0.0,
    "OperacionesGratuitas": 0.0,
    "TotalDescuentosPorItem": 0.0,
    "TotalOtrosCargos": 0.0,
    "TotalIgv": 0.0,
    "TotalOtrosTributos": 0.0,
    "TotalPrecioVenta": 121.0,
    "SubTotal": 121.0,
    "ImporteTotal": 121.0,
    "NroOrdenItem": "2",
    "UnidadMedida": "NIU",
    "Cantidad": 1,
    "CodigoProducto": "B600161971",
    "DescripcionProducto": "1709 BIEN GR 2",
    "ValorUnitario": 71.0,
    "PrecioUnitario": 71.0,
    "DescuentoPorItem": 0.0,
    "Igv": 0.0,
    "TipoIgv": "30",
    "TipoIgvDescripcion": "Inafecto - Operacion Onerosa",
    "ValorDeVenta": 71.0,
    "PrecioDeVenta": 71.0,
    "TotalDetalle": 71.0,
    "Auxiliar1": "0"
  }
]

V. Datos de salida de la API

Campos de respuesta

Caso exitoso
  • ComprobantesSí
    Tipo
    Numérico
    Longitud
    —

    Cadena con la información del comprobante emitido. Formato: EmisorNumeroDocumento, TipoDeDocumento, Serie, Correlativo.

Caso erróneo
  • TipoNo
    Tipo
    Numérico
    Longitud
    —

    Tipo de error.

  • TipoDescripcionNo
    Tipo
    Texto
    Longitud
    —

    Descripción del tipo de error.

  • LineaNo
    Tipo
    Numérico
    Longitud
    —

    Línea de ítem asociada al error.

  • DocumentoNo
    Tipo
    Texto
    Longitud
    —

    Número de serie y correlativo del documento erróneo.

  • CampoNo
    Tipo
    Texto
    Longitud
    —

    Campo relacionado al error.

  • CódigoNo
    Tipo
    Numérico
    Longitud
    —

    Código del error. Ver anexo de errores.

  • MensajeNo
    Tipo
    Texto
    Longitud
    —

    Descripción del error. Ver anexo de errores.

VI. Tramas de ejemplo de datos de salida

Ejemplos de salida

1. Ejemplo exitosoVer trama completa
Respuesta exitosa
{
  "ErroresMasivos": [],
  "Comprobantes": [
    "00000000021,FACTURA,F801,20"
  ]
}
2. Ejemplo erróneoVer trama completa
Respuesta de error
{
  "ErroresMasivos": [
    {
      "Tipo": 3,
      "TipoDescripcion": "Exclusión",
      "Linea": 0,
      "Documento": "F801-21",
      "Campo": "Correlativo",
      "Codigo": "0077",
      "Mensaje": "El correlativo del documento ya existe"
    }
  ],
  "Comprobantes": []
}

Ajustes de comprobantes

API para emisión de Nota Crédito y Débito

Esta API sirve para emitir notas de crédito, que permiten realizar anulaciones de otros documentos contables —como facturas y boletas— y devoluciones, entre otros usos. Las notas de débito permiten incrementar el valor del saldo de la cuenta de un cliente por una corrección en el documento, cobro de intereses u otro motivo. Para ambos tipos de notas es necesaria la existencia del documento contable afectado.

POSThttps://erpperuapi.smartclic.pe/Contabilidad/api/v1/masivos/notas/dto

Los resultados del uso de esta API se pueden observar en la página web del sistema. El manual enlaza el video de capacitación de búsqueda de documentos. Ver capacitación

III. Datos de entrada de la API

Parámetros de entrada

Identificación
  • SerieSí
    Tipo
    Texto
    Longitud
    4

    Serie de la nota.

  • CorrelativoSí
    Tipo
    Numérico
    Longitud
    8

    Correlativo de la nota; debe ser único.

  • FechaEmisionSí
    Tipo
    Texto
    Longitud
    10

    Fecha de emisión. Formato: aaaa-mm-dd.

  • SerieAfectadaSí
    Tipo
    Texto
    Longitud
    4

    Serie del documento afectado.

  • CorrelativoAfectadoSí
    Tipo
    Numérico
    Longitud
    8

    Correlativo del documento afectado.

  • TipoNotaSí
    Tipo
    Numérico
    Longitud
    2

    Código del tipo de nota. Ver Tipos de notas.

  • TipoNotaDescripcionSí
    Tipo
    Texto
    Longitud
    —

    Descripción del tipo de nota. Ver Tipos de notas.

  • MotivoSí
    Tipo
    Texto
    Longitud
    Máx. 100

    Motivo.

Campos condicionalesUsa únicamente los campos que correspondan al tipo de nota.
  • MontoCondicional
    Tipo
    Numérico, 2 decimales
    Longitud
    —

    Monto considerado para la emisión de la nota. Necesario para los tipos 34, 41 o 43.

  • DescripcionItemCondicional
    Tipo
    Texto
    Longitud
    Máx. 500

    Descripción del ítem afectado. Necesaria para los tipos 33, 35, 37 o 42.

  • CantidadItemCondicional
    Tipo
    Numérico
    Longitud
    —

    Cantidad en ítems. Necesaria para el tipo 37.

  • MontoItemCondicional
    Tipo
    Numérico, 2 decimales
    Longitud
    —

    Monto en ítem. Necesario para los tipos 35, 37 o 42.

  • DescripcionNuevaCondicional
    Tipo
    Texto
    Longitud
    Máx. 500

    Descripción nueva del ítem afectado. Necesaria para el tipo 33.

IV. Tramas de ejemplo de datos de entrada

Ejemplos de entrada

1. Nota de crédito por anulación de la operaciónVer trama
Body JSON
[
  {
    "Serie": "F810",
    "Correlativo": "6",
    "FechaEmision": "2024-08-07",
    "SerieAfectada": "F801",
    "CorrelativoAfectado": "17",
    "TipoNota": "31",
    "TipoNotaDescripcion": "Credito - Anulación de la operación",
    "Motivo": "Por anulación"
  }
]
2. Nota de crédito por anulación debido a error en el RUCVer trama
Body JSON
[
  {
    "Serie": "F810",
    "Correlativo": "7",
    "FechaEmision": "2024-08-07",
    "SerieAfectada": "F801",
    "CorrelativoAfectado": "18",
    "TipoNota": "32",
    "TipoNotaDescripcion": "Credito - Anulación por error en el RUC",
    "Motivo": "Hubo un error al registrar el RUC"
  }
]
3. Nota de crédito por descuento globalVer trama
Body JSON
[
  {
    "Serie": "F810",
    "Correlativo": "8",
    "FechaEmision": "2024-08-07",
    "SerieAfectada": "F801",
    "CorrelativoAfectado": "19",
    "TipoNota": "34",
    "TipoNotaDescripcion": "Credito - Descuento global",
    "Motivo": "descuento global",
    "Monto": 15.4
  }
]
4. Nota de crédito por devolución totalVer trama
Body JSON
[
  {
    "Serie": "F810",
    "Correlativo": "9",
    "FechaEmision": "2024-08-07",
    "SerieAfectada": "F801",
    "CorrelativoAfectado": "20",
    "TipoNota": "36",
    "TipoNotaDescripcion": "Credito - Devolución Total",
    "Motivo": "Producto en mal estado"
  }
]
5. Nota de débito por intereses de moraVer trama
Body JSON
[
  {
    "Serie": "F820",
    "Correlativo": "3",
    "FechaEmision": "2024-08-07",
    "SerieAfectada": "F801",
    "CorrelativoAfectado": "20",
    "TipoNota": "41",
    "TipoNotaDescripcion": "Debito - Intereses por mora",
    "Motivo": "Interes por mora",
    "Monto": 35.2
  }
]
6. Nota de débito por penalidades u otros conceptosVer trama
Body JSON
[
  {
    "Serie": "F820",
    "Correlativo": "4",
    "FechaEmision": "2024-08-07",
    "SerieAfectada": "F801",
    "CorrelativoAfectado": "21",
    "TipoNota": "43",
    "TipoNotaDescripcion": "Debito - Penalidades otros conceptos",
    "Motivo": "Penalidades por otro concepto",
    "Monto": 34.8
  }
]

V. Datos de salida de la API

Campos de respuesta

Caso exitoso
  • ComprobantesSí
    Tipo
    Numérico
    Longitud
    —

    Cadena con la información del comprobante emitido. Formato: EmisorNumeroDocumento, TipoDeDocumento, Serie, Correlativo.

Caso erróneo
  • TipoNo
    Tipo
    Numérico
    Longitud
    —

    Tipo de error.

  • TipoDescripcionNo
    Tipo
    Texto
    Longitud
    —

    Descripción del tipo de error.

  • LineaNo
    Tipo
    Numérico
    Longitud
    —

    Línea de ítem asociada al error.

  • DocumentoNo
    Tipo
    Texto
    Longitud
    —

    Número de serie y correlativo del documento erróneo.

  • CampoNo
    Tipo
    Texto
    Longitud
    —

    Campo relacionado al error.

  • CódigoNo
    Tipo
    Numérico
    Longitud
    —

    Código del error. Ver anexo de errores.

  • MensajeNo
    Tipo
    Texto
    Longitud
    —

    Descripción del error. Ver anexo de errores.

VI. Tramas de ejemplo de datos de salida

Ejemplos de salida

1. Ejemplo exitosoVer trama completa
Respuesta exitosa
{
  "ErroresMasivos": [],
  "Comprobantes": [
    "00000000021,NOTA DE DEBITO,F820,4"
  ]
}
2. Ejemplo erróneoVer trama completa
Respuesta de error
{
  "ErroresMasivos": [
    {
      "Tipo": 3,
      "TipoDescripcion": "Exclusión",
      "Linea": 0,
      "Documento": "F820-4",
      "Campo": "Correlativo",
      "Codigo": "0077",
      "Mensaje": "El correlativo del documento ya existe"
    }
  ],
  "Comprobantes": []
}

Traslado de bienes

API para emisión de Guías de Remisión Remitente y Transportista

Esta API sirve para emitir guías de remisión remitente y transportista. Las primeras se utilizan cuando la empresa emisora es quien transporta los bienes o productos; las segundas, cuando la empresa emisora terceriza el transporte. Cuando se ejecuta correctamente muestra el id del comprobante y su correlativo; cuando se ejecuta erróneamente muestra la causa.

POSThttps://erpperuapi.smartclic.pe/PuntoVenta/api/DocumentosContables/creacion/guias/masivo

Los resultados del uso de esta API se pueden observar en la página web del sistema. El manual enlaza el video de capacitación de búsqueda de documentos. Ver capacitación

III. Datos de entrada de la API

Parámetros de entrada

Guía y traslado
  • TipoGuiaSí
    Tipo
    string
    Longitud
    —

    REMITENTE o TRANSPORTISTA.

  • SerieSí
    Tipo
    string
    Longitud
    —

    Serie de la guía.

  • CorrelativoSí
    Tipo
    string
    Longitud
    —

    Correlativo de la guía.

  • FechaEmisionSí
    Tipo
    string (date)
    Longitud
    —

    Fecha de emisión.

  • FechaTrasladoSí
    Tipo
    string (date)
    Longitud
    —

    Fecha prevista para el inicio del traslado.

  • MotivoTrasladoSí
    Tipo
    string
    Longitud
    —

    Código del motivo de traslado.

  • ModalidadTrasladoSí
    Tipo
    string
    Longitud
    —

    01 transporte público o 02 transporte privado.

  • NumeroDAMNo
    Tipo
    string
    Longitud
    —

    Número de Declaración Aduanera de Mercancías cuando corresponda.

  • CantidadBultosSí
    Tipo
    decimal
    Longitud
    —

    Cantidad total de bultos.

  • TotalPesoBrutoSí
    Tipo
    decimal
    Longitud
    —

    Peso bruto total del traslado.

  • ObservacionNo
    Tipo
    string
    Longitud
    —

    Observaciones del traslado.

Puntos de partida y llegada
  • UbigeoPartidaSí
    Tipo
    string
    Longitud
    —

    Ubigeo del punto de partida.

  • DireccionPartidaSí
    Tipo
    string
    Longitud
    —

    Dirección de partida.

  • UbigeoLlegadaSí
    Tipo
    string
    Longitud
    —

    Ubigeo del punto de llegada.

  • DireccionLlegadaSí
    Tipo
    string
    Longitud
    —

    Dirección de llegada.

Partes y transporte
  • DestinatarioTipoDocumentoSí
    Tipo
    string
    Longitud
    —

    Tipo de documento del destinatario.

  • DestinatarioNumeroDocumentoSí
    Tipo
    string
    Longitud
    —

    Documento del destinatario.

  • DestinatarioRazonSocialONombresSí
    Tipo
    string
    Longitud
    —

    Razón social o nombres del destinatario.

  • RemitenteTipoDocumentoNo
    Tipo
    string
    Longitud
    —

    Tipo de documento del remitente.

  • RemitenteNumeroDocumentoNo
    Tipo
    string
    Longitud
    —

    Documento del remitente.

  • RemitenteRazonSocialONombresNo
    Tipo
    string
    Longitud
    —

    Razón social o nombres del remitente.

  • TransportistaNumeroDocumentoNo
    Tipo
    string
    Longitud
    —

    RUC del transportista.

  • TransportistaRazonSocialNo
    Tipo
    string
    Longitud
    —

    Razón social del transportista.

  • NumeroRegistroMTCNo
    Tipo
    string
    Longitud
    —

    Registro MTC del transportista.

  • TUCEoHabilitacionVehicularNo
    Tipo
    string
    Longitud
    —

    TUC o habilitación vehicular.

  • ConductorTipoDocumentoNo
    Tipo
    string
    Longitud
    —

    Tipo de documento del conductor.

  • ConductorNumeroDocumentoNo
    Tipo
    string
    Longitud
    —

    Documento del conductor.

  • ConductorRazonSocialNo
    Tipo
    string
    Longitud
    —

    Nombre o razón social del conductor.

  • ConductorPlacaNo
    Tipo
    string
    Longitud
    —

    Placa del vehículo.

  • ConductorLicenciaConducirNo
    Tipo
    string
    Longitud
    —

    Licencia del conductor.

Retorno, flete y autorización
  • RetornoNo
    Tipo
    string
    Longitud
    —

    Indicador de retorno según el dominio del manual.

  • RetornoTransporteSubcontratadoNumeroDocumentoNo
    Tipo
    string
    Longitud
    —

    Documento del transporte subcontratado.

  • RetornoTransporteSubcontratadoRazonSocialNo
    Tipo
    string
    Longitud
    —

    Razón social del transporte subcontratado.

  • PagadorFleteNo
    Tipo
    string
    Longitud
    —

    Parte responsable del pago del flete.

  • PagadorFleteNoRemitenteNumeroDocumentoNo
    Tipo
    string
    Longitud
    —

    Documento del pagador cuando no es el remitente.

  • PagadorFleteNoRemitenteRazonSocialNo
    Tipo
    string
    Longitud
    —

    Razón social del pagador cuando no es el remitente.

  • EntidadEmisoraNo
    Tipo
    string
    Longitud
    —

    Código de la entidad que emite la autorización.

  • NumeroAutorizacionNo
    Tipo
    string
    Longitud
    —

    Número de autorización aplicable.

Bienes trasladados
  • NroOrdenItemSí
    Tipo
    integer
    Longitud
    —

    Orden del ítem.

  • UnidadMedidaSí
    Tipo
    string
    Longitud
    —

    Unidad de medida.

  • CantidadSí
    Tipo
    decimal
    Longitud
    —

    Cantidad trasladada.

  • CodigoProductoSí
    Tipo
    string
    Longitud
    —

    Código del producto.

  • DescripcionProductoSí
    Tipo
    string
    Longitud
    —

    Descripción del bien trasladado.

  • Auxiliar1No
    Tipo
    string
    Longitud
    —

    Dato auxiliar opcional.

IV. Tramas de ejemplo de datos de entrada

Ejemplos de entrada

1. Guía remitente: venta con modalidad públicaVer trama
Body JSON
[
  {
    "TipoGuia": "REMITENTE",
    "Serie": "T013",
    "Correlativo": 5,
    "FechaEmision": "2024-08-07",
    "FechaTraslado": "2024-08-07",
    "MotivoTraslado": "01",
    "ModalidadTraslado": "01",
    "DestinatarioTipoDocumento": "DNI",
    "DestinatarioNumeroDocumento": "73641789",
    "DestinatarioRazonSocialONombres": "DIEGO JOEL FLORES CAMARGO",
    "Observacion": "Obs Test GRR de la guía con un solo producto",
    "UbigeoPartida": "040101",
    "DireccionPartida": "AQP direccion inicial",
    "UbigeoLlegada": "040102",
    "DireccionLlegada": "aqp direccion final",
    "TransportistaNumeroDocumento": "20498189637",
    "TransportistaRazonSocial": "AREQUIPA EXPRESO MARVISUR EIRL",
    "NumeroRegistroMTC": "",
    "TotalPesoBruto": "14.65",
    "Auxiliar1": "0",
    "NroOrdenItem": 1,
    "UnidadMedida": "NIU",
    "Cantidad": 5,
    "CodigoProducto": "00000000",
    "DescripcionProducto": "manual test item"
  }
]
2. Guía remitente: compra con modalidad privadaVer trama
Body JSON
[
  {
    "TipoGuia": "REMITENTE",
    "Serie": "T013",
    "Correlativo": 6,
    "FechaEmision": "2024-08-07",
    "FechaTraslado": "2024-08-07",
    "MotivoTraslado": "02",
    "ModalidadTraslado": "02",
    "DestinatarioTipoDocumento": "RUC",
    "DestinatarioNumeroDocumento": "20539622031",
    "DestinatarioRazonSocialONombres": "SMART REASONS S.R.L.",
    "Observacion": "Test GRR motivo - COMPRA - privada - 2 ítem - destinatario RUC",
    "UbigeoPartida": "040110",
    "DireccionPartida": "AQP casa roy S/N",
    "UbigeoLlegada": "040129",
    "DireccionLlegada": "aqp casa manuel m-1",
    "ConductorTipoDocumento": "DNI",
    "ConductorNumeroDocumento": "44191073",
    "ConductorRazonSocial": "MANUEL ARROSPIDE CHIRINOS",
    "ConductorPlaca": "V4F026",
    "ConductorLicenciaConducir": "H44191073",
    "EntidadEmisora": "",
    "NumeroAutorizacion": "",
    "TotalPesoBruto": "100",
    "Auxiliar1": "0",
    "NroOrdenItem": 1,
    "UnidadMedida": "NIU",
    "Cantidad": 5,
    "CodigoProducto": "00000000",
    "DescripcionProducto": "manual test item"
  },
  {
    "TipoGuia": "REMITENTE",
    "Serie": "T013",
    "Correlativo": 6,
    "FechaEmision": "2024-08-07",
    "FechaTraslado": "2024-08-07",
    "MotivoTraslado": "02",
    "ModalidadTraslado": "02",
    "DestinatarioTipoDocumento": "RUC",
    "DestinatarioNumeroDocumento": "20539622031",
    "DestinatarioRazonSocialONombres": "SMART REASONS S.R.L.",
    "Observacion": "Test GRR motivo - COMPRA - privada - 3 ítem - destinatario Dni",
    "UbigeoPartida": "040110",
    "DireccionPartida": "AQP casa roy S/N",
    "UbigeoLlegada": "040129",
    "DireccionLlegada": "aqp casa manuel m-1",
    "ConductorTipoDocumento": "DNI",
    "ConductorNumeroDocumento": "44191073",
    "ConductorRazonSocial": "MANUEL ARROSPIDE CHIRINOS",
    "ConductorPlaca": "V4F026",
    "ConductorLicenciaConducir": "H44191073",
    "EntidadEmisora": "",
    "NumeroAutorizacion": "",
    "TotalPesoBruto": "100",
    "Auxiliar1": "0",
    "NroOrdenItem": 2,
    "UnidadMedida": "BX",
    "Cantidad": 6,
    "CodigoProducto": "P00005",
    "DescripcionProducto": "gaseosa 30062026"
  }
]
3. Guía remitente: otros motivos con modalidad públicaVer trama
Body JSON
[
  {
    "TipoGuia": "REMITENTE",
    "Serie": "T013",
    "Correlativo": 7,
    "FechaEmision": "2024-08-07",
    "FechaTraslado": "2024-08-07",
    "MotivoTraslado": "13",
    "ModalidadTraslado": "01",
    "DestinatarioTipoDocumento": "DNI",
    "DestinatarioNumeroDocumento": "72123456",
    "DestinatarioRazonSocialONombres": "MARIELENA VILCA QUISPE",
    "Observacion": "Obs Test GRR de la guía con dos productos",
    "UbigeoPartida": "040101",
    "DireccionPartida": "AQP direccion inicial",
    "UbigeoLlegada": "040102",
    "DireccionLlegada": "aqp direccion final",
    "TransportistaNumeroDocumento": "20498189637",
    "TransportistaRazonSocial": "AREQUIPA EXPRESO MARVISUR EIRL",
    "NumeroRegistroMTC": "MTC123",
    "EntidadEmisora": "11",
    "NumeroAutorizacion": "MINSAJULIO2023",
    "TotalPesoBruto": "14.65",
    "Auxiliar1": "0",
    "NroOrdenItem": 1,
    "UnidadMedida": "NIU",
    "Cantidad": 1,
    "CodigoProducto": "00000000",
    "DescripcionProducto": "manual test item"
  },
  {
    "TipoGuia": "REMITENTE",
    "Serie": "T013",
    "Correlativo": 7,
    "FechaEmision": "2024-08-07",
    "FechaTraslado": "2023-08-07",
    "MotivoTraslado": "13",
    "ModalidadTraslado": "01",
    "DestinatarioTipoDocumento": "DNI",
    "DestinatarioNumeroDocumento": "72123456",
    "DestinatarioRazonSocialONombres": "MARIELENA VILCA QUISPE",
    "Observacion": "Obs Test GRR de la guía con dos productos",
    "UbigeoPartida": "040101",
    "DireccionPartida": "AQP direccion inicial",
    "UbigeoLlegada": "040102",
    "DireccionLlegada": "aqp direccion final",
    "TransportistaNumeroDocumento": "20498189637",
    "TransportistaRazonSocial": "AREQUIPA EXPRESO MARVISUR EIRL",
    "NumeroRegistroMTC": "MTC123",
    "EntidadEmisora": "11",
    "NumeroAutorizacion": "MINSAJULIO2023",
    "TotalPesoBruto": "14.65",
    "Auxiliar1": "0",
    "NroOrdenItem": 2,
    "UnidadMedida": "NIU",
    "Cantidad": 1,
    "CodigoProducto": "00000000",
    "DescripcionProducto": "manual test item2"
  }
]
4. Guía transportista: retorno de vehículo con envases o embalajes vacíosVer trama
Body JSON
[
  {
    "TipoGuia": "TRANSPORTISTA",
    "Serie": "V069",
    "Correlativo": 15,
    "FechaEmision": "2024-08-07",
    "FechaTraslado": "2024-08-07",
    "Retorno": "SUNAT_Envio_IndicadorRetornoVehiculoEnvaseVacio",
    "PagadorFlete": "SUNAT_Envio_IndicadorPagadorFlete_Remitente",
    "ConductorTipoDocumento": "DNI",
    "ConductorNumeroDocumento": "44191073",
    "ConductorRazonSocial": "MANUEL AC",
    "ConductorPlaca": "V4F026",
    "ConductorLicenciaConducir": "H44191073",
    "EntidadEmisora": "11",
    "NumeroAutorizacion": "MINSAJULIO2023",
    "RemitenteTipoDocumento": "DNI",
    "RemitenteNumeroDocumento": "48210971",
    "RemitenteRazonSocialONombres": "FLOR GUTIERREZ LLOCLLE",
    "DestinatarioTipoDocumento": "CARNETDEEXTRANJERIA",
    "DestinatarioNumeroDocumento": "CE001499897",
    "DestinatarioRazonSocialONombres": "JEAN LOUIS GELOT",
    "Observacion": "Obs Test GRT",
    "UbigeoPartida": "040101",
    "DireccionPartida": "AQP direccion inicial",
    "UbigeoLlegada": "040102",
    "DireccionLlegada": "aqp direccion final",
    "TotalPesoBruto": "101",
    "Auxiliar1": "0",
    "NroOrdenItem": 1,
    "UnidadMedida": "ONZ",
    "Cantidad": 5,
    "CodigoProducto": "000000023",
    "DescripcionProducto": "manual test item onzas"
  }
]
5. Guía transportista: retorno de vehículo vacío y flete subcontratadoVer trama
Body JSON
[
  {
    "TipoGuia": "TRANSPORTISTA",
    "Serie": "V069",
    "Correlativo": 16,
    "FechaEmision": "2024-08-07",
    "FechaTraslado": "2024-08-07",
    "Retorno": "SUNAT_Envio_IndicadorRetornoVehiculoVacio",
    "PagadorFlete": "SUNAT_Envio_IndicadorPagadorFlete_Subcontratador",
    "PagadorFleteNoRemitenteNumeroDocumento": "20498189637",
    "PagadorFleteNoRemitenteRazonSocial": "AREQUIPA EXPRESO MARVISUR EIRL",
    "ConductorTipoDocumento": "DNI",
    "ConductorNumeroDocumento": "44191073",
    "ConductorRazonSocial": "MANUEL AC",
    "ConductorPlaca": "V4F026",
    "ConductorLicenciaConducir": "H44191073",
    "EntidadEmisora": "11",
    "NumeroAutorizacion": "MINSAJULIO2023",
    "RemitenteTipoDocumento": "RUC",
    "RemitenteNumeroDocumento": "20163646499",
    "RemitenteRazonSocialONombres": "UNIVERSIDAD NACIONAL DE SAN AGUSTIN",
    "DestinatarioTipoDocumento": "CARNETDEEXTRANJERIA",
    "DestinatarioNumeroDocumento": "CE001499897",
    "DestinatarioRazonSocialONombres": "JEAN LOUIS GELOT",
    "Observacion": "Obs Test GRT",
    "UbigeoPartida": "040101",
    "DireccionPartida": "AQP direccion inicial",
    "UbigeoLlegada": "040102",
    "DireccionLlegada": "aqp direccion final",
    "TotalPesoBruto": "101.12345",
    "Auxiliar1": "0",
    "NroOrdenItem": 1,
    "UnidadMedida": "ONZ",
    "Cantidad": 5,
    "CodigoProducto": "000000023",
    "DescripcionProducto": "manual test item onzas"
  }
]
6. Guía transportista: transporte subcontratado y flete pagado por tercerosVer trama
Body JSON
[
  {
    "TipoGuia": "TRANSPORTISTA",
    "Serie": "V069",
    "Correlativo": 17,
    "FechaEmision": "2024-08-07",
    "FechaTraslado": "2024-08-07",
    "Retorno": "SUNAT_Envio_IndicadorTrasporteSubcontratado",
    "RetornoTransporteSubcontratadoNumeroDocumento": "20163646499",
    "RetornoTransporteSubcontratadoRazonSocial": "UNIVERSIDAD NACIONAL DE SAN AGUSTIN",
    "PagadorFlete": "SUNAT_Envio_IndicadorPagadorFlete_Tercero",
    "PagadorFleteNoRemitenteNumeroDocumento": "20163646499",
    "PagadorFleteNoRemitenteRazonSocial": "UNIVERSIDAD NACIONAL DE SAN AGUSTIN",
    "DestinatarioTipoDocumento": "RUC",
    "DestinatarioNumeroDocumento": "20415932376",
    "DestinatarioRazonSocialONombres": "COCA-COLA SERVICIOS DE PERU S.A",
    "RemitenteTipoDocumento": "PASAPORTE",
    "RemitenteNumeroDocumento": "120342711",
    "RemitenteRazonSocialONombres": "CALDERON RODRIGUEZ VALERIA NICOLL",
    "Observacion": "Obs Test GRT",
    "UbigeoPartida": "040101",
    "DireccionPartida": "AQP direccion inicial",
    "UbigeoLlegada": "040102",
    "DireccionLlegada": "aqp direccion final",
    "NumeroRegistroMTC": "",
    "TUCEoHabilitacionVehicular": "",
    "ConductorTipoDocumento": "DNI",
    "ConductorNumeroDocumento": "73736462",
    "ConductorRazonSocial": "ANTONIO JOSÉ MEJIA",
    "ConductorPlaca": "V8V498",
    "ConductorLicenciaConducir": "H73736462",
    "EntidadEmisora": "02",
    "NumeroAutorizacion": "123456",
    "TotalPesoBruto": "3",
    "Auxiliar1": "0",
    "NroOrdenItem": 1,
    "UnidadMedida": "SET",
    "Cantidad": 5.01,
    "CodigoProducto": "0000VALE",
    "DescripcionProducto": "manual test item docenas"
  },
  {
    "TipoGuia": "TRANSPORTISTA",
    "Serie": "V069",
    "Correlativo": 17,
    "FechaEmision": "2024-08-07",
    "FechaTraslado": "2024-08-07",
    "Retorno": "SUNAT_Envio_IndicadorTrasporteSubcontratado",
    "RetornoTransporteSubcontratadoNumeroDocumento": "20163646499",
    "RetornoTransporteSubcontratadoRazonSocial": "UNIVERSIDAD NACIONAL DE SAN AGUSTIN",
    "PagadorFlete": "SUNAT_Envio_IndicadorPagadorFlete_Tercero",
    "PagadorFleteNoRemitenteNumeroDocumento": "20163646499",
    "PagadorFleteNoRemitenteRazonSocial": "UNIVERSIDAD NACIONAL DE SAN AGUSTIN",
    "DestinatarioTipoDocumento": "RUC",
    "DestinatarioNumeroDocumento": "20415932376",
    "DestinatarioRazonSocialONombres": "COCA-COLA SERVICIOS DE PERU S.A",
    "RemitenteTipoDocumento": "PASAPORTE",
    "RemitenteNumeroDocumento": "120342711",
    "RemitenteRazonSocialONombres": "CALDERON RODRIGUEZ VALERIA NICOLL",
    "Observacion": "Obs Test GRT",
    "UbigeoPartida": "040101",
    "DireccionPartida": "AQP direccion inicial",
    "UbigeoLlegada": "040102",
    "DireccionLlegada": "aqp direccion final",
    "NumeroRegistroMTC": "",
    "TUCEoHabilitacionVehicular": "",
    "ConductorTipoDocumento": "DNI",
    "ConductorNumeroDocumento": "73736462",
    "ConductorRazonSocial": "ANTONIO JOSÉ MEJIA",
    "ConductorPlaca": "V8V498",
    "ConductorLicenciaConducir": "H73736462",
    "EntidadEmisora": "02",
    "NumeroAutorizacion": "123456",
    "TotalPesoBruto": "3",
    "Auxiliar1": "0",
    "NroOrdenItem": 2,
    "UnidadMedida": "SET",
    "Cantidad": 6.12,
    "CodigoProducto": "VALE0000",
    "DescripcionProducto": "manual test item DOS"
  }
]

V. Datos de salida de la API

Campos de respuesta

Caso exitoso
  • IdComprobanteSí
    Tipo
    Numérico
    Longitud
    —

    Id del comprobante.

  • CorrelativoDocumentoSí
    Tipo
    Numérico
    Longitud
    —

    Correlativo del comprobante.

Caso erróneo
  • TipoNo
    Tipo
    Numérico
    Longitud
    —

    Tipo de error.

  • TipoDescripcionNo
    Tipo
    Texto
    Longitud
    —

    Descripción del tipo de error.

  • LineaNo
    Tipo
    Numérico
    Longitud
    —

    Línea de ítem asociada al error.

  • DocumentoNo
    Tipo
    Texto
    Longitud
    —

    Número de serie y correlativo del documento erróneo.

  • CampoNo
    Tipo
    Texto
    Longitud
    —

    Campo relacionado al error.

  • CódigoNo
    Tipo
    Numérico
    Longitud
    —

    Código del error. Ver anexo de errores.

  • MensajeNo
    Tipo
    Texto
    Longitud
    —

    Descripción del error. Ver anexo de errores.

VI. Tramas de ejemplo de datos de salida

Ejemplos de salida

1. Ejemplo exitosoVer trama completa
Respuesta exitosa
{
  "EmisionReponseDTOs": [
    {
      "IdComprobante": 21486400,
      "CorrelativoDocumento": 5
    }
  ]
}
2. Ejemplo erróneoVer trama completa
Respuesta de error
{
  "GuiasMasivasErrores": [
    {
      "Tipo": 3,
      "TipoDescripcion": "Error",
      "Linea": 0,
      "Documento": "V069-16",
      "Campo": "Correlativo",
      "Codigo": "0077",
      "Mensaje": "El correlativo del documento ya existe"
    }
  ]
}

Lectura de comprobantes

API para consulta de documentos

Esta API sirve para consultar los documentos contables generados como facturas, boletas y notas de crédito o débito. Cuando se ejecuta correctamente retorna toda la información del documento; cuando se ejecuta erróneamente muestra la causa.

POSThttps://erpperuapi.smartclic.pe/PuntoVenta/api/DocumentosContables/Consultas/Integracion

Los resultados del uso de esta API se pueden observar en la página web del sistema. El manual enlaza el video de capacitación de búsqueda de documentos. Ver capacitación

III. Datos de entrada de la API

Parámetros de entrada

Cuerpo (body)
  • EmisorNumeroDocumentoSí
    Tipo
    Texto
    Longitud
    11

    Número de documento del emisor del comprobante (RUC).

  • TipoDocumentoDescripcionSí
    Tipo
    Texto
    Longitud
    —

    FACTURA, BOLETA, NOTA DE CREDITO, NOTA DE DEBITO, GUIA DE REMISION REMITENTE o GUIA DE REMISION TRANSPORTISTA.

  • SerieDescripcionSí
    Tipo
    Texto
    Longitud
    —

    Serie del comprobante a consultar.

  • CorrelativoDocumentoSí
    Tipo
    Texto
    Longitud
    —

    Correlativo del comprobante a consultar. En la tabla del manual aparece como “CorrelativoDescripción”; la trama de ejemplo utiliza “CorrelativoDocumento”.

IV. Tramas de ejemplo de datos de entrada

Ejemplos de entrada

1. Consulta de documentosVer trama
Body JSON
{
  "EmisorNumeroDocumento": "00000000021",
  "TipoDocumentoDescripcion": "FACTURA",
  "SerieDescripcion": "F801",
  "CorrelativoDocumento": 22
}

V. Datos de salida de la API

Campos de respuesta

Caso exitoso (campos más relevantes)
  • SerieDescripcionSí
    Tipo
    Texto
    Longitud
    4

    Serie del documento.

  • CorrelativoDocumentoSí
    Tipo
    Numérico
    Longitud
    8

    Correlativo del documento.

  • FechaEmisionSí
    Tipo
    Texto
    Longitud
    10

    Fecha de emisión del documento.

  • FechaVencimientoNo
    Tipo
    Texto
    Longitud
    10

    Fecha de vencimiento.

  • MonedaDescripcionSí
    Tipo
    Texto
    Longitud
    —

    Tipo de moneda.

  • CondicionPagoSí
    Tipo
    Texto
    Longitud
    —

    Condición de pago.

  • CuotasCondicional
    Tipo
    Texto | Numérico
    Longitud
    —

    Obligatorio cuando la condición de pago es 2 (Crédito). Cuotas Fecha|Monto separadas por coma.

  • ReceptorRazonSocialSí
    Tipo
    Texto
    Longitud
    —

    Nombre del receptor.

  • ReceptorTipoDocumentoSí
    Tipo
    Texto
    Longitud
    19

    Tipo de documento del receptor: DNI, RUC, PASAPORTE o CARNETDEEXTRANJERIA.

  • ReceptorNumeroDocumentoSí
    Tipo
    Texto
    Longitud
    —

    Número de documento del receptor.

  • ReceptorCorreoSí
    Tipo
    Texto
    Longitud
    —

    Correo del receptor.

  • DireccionReceptorSí
    Tipo
    Texto
    Longitud
    —

    Dirección del receptor.

  • ObservacionesSí
    Tipo
    Texto
    Longitud
    Máx. 200

    Observación.

  • OperacionesGravadasSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de operaciones gravadas.

  • OperacionesInafectasSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de operaciones inafectas.

  • OperacionesExoneradasSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de operaciones exoneradas.

  • OperacionesGratuitasSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de operaciones gratuitas.

  • OperacionesExportadasCondicional
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de operaciones exportadas.

  • TotalDescuentosPorItemSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Sumatoria de descuentos por ítem.

  • TotalOtrosCargosSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de otros cargos.

  • MontoIgvSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de IGV.

  • TotalOtrosTributosSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total de otros tributos.

  • MontoSubTotalSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Subtotal de la venta.

  • TotalPrecioVentaSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total del precio de venta, incluido IGV.

  • DetraccionNo
    Tipo
    Texto
    Longitud
    —

    Uso de detracciones: true o false.

  • DetraccionPorcentajeCondicional
    Tipo
    Numérico
    Longitud
    —

    Porcentaje de detracción. Obligatorio si Detraccion es true. Sin decimales.

  • DetraccionCodigoMedioPagoCondicional
    Tipo
    Numérico
    Longitud
    —

    Código del medio de pago según SUNAT. Obligatorio si Detraccion es true.

  • DetraccionNrocuentaCondicional
    Tipo
    Texto
    Longitud
    —

    Número de cuenta para detracciones. Obligatorio si Detraccion es true.

  • DetraccionCodigoBienServicioCondicional
    Tipo
    Numérico
    Longitud
    —

    Código del bien o servicio. Obligatorio si Detraccion es true.

  • MontoDetraccionNo
    Tipo
    Numérico
    Longitud
    —

    Monto de la detracción.

  • ItemSí
    Tipo
    Numérico
    Longitud
    —

    Número de orden del ítem.

  • CantidadSí
    Tipo
    Numérico
    Longitud
    —

    Cantidad por ítem.

  • CodigoItemSí
    Tipo
    Texto
    Longitud
    Máx. 10

    Código del producto.

  • ItemDescripcionSí
    Tipo
    Texto
    Longitud
    Máx. 500

    Descripción del producto o servicio.

  • DescripcionUnidadSí
    Tipo
    Texto
    Longitud
    —

    Unidad de medida del ítem.

  • ValorUnitarioSí
    Tipo
    Numérico, 2 a 8 decimales
    Longitud
    —

    Valor unitario del ítem, sin IGV.

  • PrecioUnitarioVentaSí
    Tipo
    Numérico, 2 a 8 decimales
    Longitud
    —

    Precio unitario del ítem, con IGV.

  • DescuentoSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Descuento por ítem.

  • IGVSí
    Tipo
    Numérico, dos decimales
    Longitud
    —

    IGV del ítem por cantidad.

  • TipoIgvSí
    Tipo
    Numérico
    Longitud
    2

    Código de tipo de afectación de IGV.

  • TipoIgvDescripcionSí
    Tipo
    Texto
    Longitud
    —

    Descripción de tipo de afectación de IGV.

  • SubtotalNo
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Valor de venta del ítem: ValorUnitario × Cantidad.

  • PrecioVentaItemNo
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Precio de venta del ítem: PrecioUnitarioVenta × Cantidad, incluido IGV.

  • TotalNo
    Tipo
    Numérico, dos decimales
    Longitud
    —

    Total del detalle.

  • Auxiliar1Sí
    Tipo
    Numérico
    Longitud
    1

    Siempre con el valor 0.

  • TipoDocDescripcionSí
    Tipo
    Texto
    Longitud
    —

    Tipo de documento.

  • EstadoSunatDescripcionNo
    Tipo
    Texto
    Longitud
    —

    Estado del documento en SUNAT.

  • TipoDeNotaNo
    Tipo
    Texto
    Longitud
    —

    Tipo de nota.

  • DocumentoRelacionadoNo
    Tipo
    Texto
    Longitud
    —

    Documento al cual se le aplicó la nota.

  • NumeroCuotaCondicional
    Tipo
    Numérico
    Longitud
    —

    Solo cuando la condición de pago sea crédito.

  • MontoCondicional
    Tipo
    Numérico
    Longitud
    —

    Solo cuando la condición de pago sea crédito.

  • FechaVencimientoCondicional
    Tipo
    Texto
    Longitud
    —

    Solo cuando la condición de pago sea crédito.

Caso erróneo
  • IdErrorSí
    Tipo
    Numérico
    Longitud
    —

    Código del error.

  • MensajeSí
    Tipo
    Texto
    Longitud
    —

    Descripción del error.

  • TrazaSí
    Tipo
    Texto
    Longitud
    —

    Información más detallada del error en el sistema.

VI. Tramas de ejemplo de datos de salida

Ejemplos de salida

1. Ejemplo exitosoVer trama completa
Respuesta exitosa
[
  {
    "IdComprobanteERP": 22179903,
    "IdTipoDocumento": 1003,
    "TipoDocCodigo": "01",
    "TipoDocDescripcion": "FACTURA",
    "TipoDocAbreviacion": "F",
    "IdEstadoComprobante": 2,
    "EstadoDescripcion": "EMITIDO",
    "IdEstadoSunat": 2,
    "IdMoneda": 1,
    "MonedaCodigo": "PEN",
    "MonedaDescripcion": "SOLES",
    "MonedaAbreviacion": "S/",
    "IdCondicionPago": 19112,
    "IdSerie": 182949,
    "IdEmpresa": 1361941,
    "TipoOperacion": 2,
    "CorrelativoDocumento": 22,
    "IdOrigen": "0",
    "Direccion": "Av. El sol 105 - Paucarpata",
    "IdModulo": 31,
    "IdEntidadEmisor": 1361941,
    "IdEntidadReceptora": 60005,
    "IdEntidadPersona": 0,
    "MontoSubTotal": 63.56,
    "MontoIGV": 11.44,
    "MontoISC": 0.0,
    "MontoTotal": 75.0,
    "MontoTotalDescripcion": "SETENTA Y CINCO CON 00/100",
    "ValorIGV": 0.18,
    "OtrosTributos": 0.0,
    "OtrosCargos": 0.0,
    "MontoIGVGratuito": 0.0,
    "PesoBruto": 0.0,
    "PesoNeto": 0.0,
    "TotalPrecioVenta": 75.0,
    "FechaEmision": "2024-08-08T00:00:00",
    "FechaVencimiento": "2024-08-08T00:00:00",
    "Observaciones": "Ninguna",
    "Icbper": 0.0,
    "Sincronizado": true,
    "VersionDocumentoEntidad": 1,
    "VersionDocumentoConcepto": 1,
    "VersionDocumentoArchivo": 1,
    "VersionDetalleDocumento": 1,
    "VersionDetalleAdicional": 1,
    "VersionDocumentoParametro": 1,
    "VersionDocumentoReferencia": 1,
    "NumeroDocumentoFormateado": "00000022",
    "ValorIGVDescripcion": "18",
    "MontoEnLetras": "SETENTA Y CINCO CON 00/100",
    "EstadoSunatDescripcion": "ACEPTADA",
    "FechaEmisionFormateada": "08/08/2024",
    "EmisorNumeroDocumento": "00000000021",
    "EmisorRazonSocial": "EMPRESA DEMO API",
    "EmisorCorreo": "",
    "ReceptorIdTipoDoc": 2,
    "ReceptorTipoDocumento": "RUC",
    "ReceptorNumeroDocumento": "10434365533",
    "ReceptorRazonSocial": "ROSADO ROLDAN LUIS FERNANDO",
    "ReceptorCorreo": "",
    "DireccionReceptor": "Av. El sol 105 - Paucarpata",
    "Idcliente": 1550521,
    "OperacionesGravadas": 63.56,
    "OperacionesExoneradas": 0.0,
    "OperacionesInafectas": 0.0,
    "OperacionesGratuitas": 0.0,
    "OperacionesExportadas": 0.0,
    "MontoDetraccion": 0.0,
    "MontoDescuento": 0.0,
    "ValorVenta": 63.56,
    "SumaDescuentosNoAfectanBase": 0.0,
    "SumatoriaIcbper": 0.0,
    "TicketComunicacionBaja": "",
    "TicketResumenBoletas": "",
    "ValorResumen": "",
    "ListaPrecios": "",
    "EsAdelanto": "",
    "DescuentosGlobales": 0.0,
    "NombreArchivoPDF": "smartcontabilidad.s3-us-west-2.amazonaws.com/00000000021/F801-00000022-22159462-PDF.pdf",
    "DescuentosTotales": 0.0,
    "SucursalCodigoDomiciliario": "180148",
    "IdSucursal": 0,
    "MinItem": [],
    "TieneDatoAdicional": false,
    "TieneNotaCredito": false,
    "IdEstadoDocFinanciero": 0,
    "IdDocFinanciero": 0,
    "CondicionPago": "CONTADO",
    "SerieDescripcion": "F801",
    "MontoPercepcion": 0.0,
    "MontoRetencion": 0.0,
    "MontoAnticipo": 0.0,
    "FechaVencimientoFormateada": "08/08/2024",
    "TieneDocumentoFinanciero": 0,
    "PedidoAtentido": 0,
    "TotalAdelantos": 0.0,
    "LogFechaModif": "2024-08-08T16:24:13.83",
    "LogFechaModifFormateado": "08/08/2024 16:24",
    "IdTipoCreacion": 5,
    "DetalleTramos": [],
    "TokenEmision": "",
    "IdUsuario": "",
    "ListaItems": [
      {
        "IdDocumentoContable": 22159462,
        "Item": 1,
        "CodigoItem": "F99988",
        "ItemDescripcion": "1709 BIEN GR",
        "PrecioUnitarioVenta": 30.0,
        "PrecioUnitario": 30.0,
        "CodigoUnidad": "NIU",
        "DescripcionUnidad": "NIU",
        "Cantidad": 1.0,
        "SubTotal": 25.42,
        "MontoISC": 0.0,
        "IGV": 4.58,
        "Descuento": 0.0,
        "ValorIGV": 0.18,
        "IdMSOrigen": 4,
        "IdOrigen": "0",
        "IdDetalleOrigen": "0",
        "ValorUnitario": 25.42,
        "Total": 30.0,
        "PrecioVentaItem": 30.0,
        "CodigoSunat": "",
        "TipoTributoTipo": "",
        "TipoTributoValor": "",
        "TipoTributoAuxiliar1": "",
        "TipoTributoAuxiliar2": "",
        "TipoTributoAuxiliar3": "",
        "TipoIgvIdParametro": 3,
        "TipoIgvIdDominio": 10,
        "TipoIgvTipo": "1",
        "TipoIgvValor": "",
        "TipoIgvAuxiliar2": "",
        "TipoIgvAuxiliar3": "clientes varios",
        "TipoIscTipo": "",
        "TipoIscValor": "",
        "TipoIscAuxiliar1": "",
        "TipoIscAuxiliar2": "",
        "TipoIscAuxiliar3": "",
        "TipoVentaIdParametro": 12,
        "TipoVentaIdDominio": 106,
        "TipoVentaTipo": "1",
        "TipoVentaValor": "",
        "TipoVentaAuxiliar2": "",
        "TipoVentaAuxiliar3": "clientes varios",
        "TipoCargoTipo": "",
        "TipoCargoValor": "",
        "TipoCargoAuxiliar1": "",
        "TipoCargoAuxiliar2": "",
        "TipoCargoAuxiliar3": "",
        "LogVersion": 0,
        "DescuentoVista": 0.0,
        "OtrosCargosItem": 0.0,
        "OtrosTributos": 0.0,
        "ICBPER": 0.0,
        "DescuentoPrecio": 0.0,
        "ListaParametros": [
          {
            "IdDetalleDocumento": 45643547,
            "IdDominio": 10,
            "IdParametro": 3,
            "Tipo": "1",
            "Valor": "",
            "Auxiliar2": "",
            "Auxiliar3": "clientes varios",
            "Id": 0,
            "LogUsuariocrea": "demo-api",
            "LogFechacrea": "2024-08-08T16:23:56.943",
            "LogUsuariomodif": "demo-api",
            "LogFechamodif": "2024-08-08T16:23:56.943",
            "LogEstado": 1
          },
          {
            "IdDetalleDocumento": 45643547,
            "IdDominio": 106,
            "IdParametro": 12,
            "Tipo": "1",
            "Valor": "",
            "Auxiliar2": "",
            "Auxiliar3": "clientes varios",
            "Id": 0,
            "LogUsuariocrea": "demo-api",
            "LogFechacrea": "2024-08-08T16:23:56.943",
            "LogUsuariomodif": "demo-api",
            "LogFechamodif": "2024-08-08T16:23:56.943",
            "LogEstado": 1
          }
        ],
        "Id": 45643547,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:56.943",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:56.943",
        "LogEstado": 1
      },
      {
        "IdDocumentoContable": 22159462,
        "Item": 2,
        "CodigoItem": "B600161971",
        "ItemDescripcion": "1709 BIEN GR 2",
        "PrecioUnitarioVenta": 45.0,
        "PrecioUnitario": 45.0,
        "CodigoUnidad": "NIU",
        "DescripcionUnidad": "NIU",
        "Cantidad": 1.0,
        "SubTotal": 38.14,
        "MontoISC": 0.0,
        "IGV": 6.86,
        "Descuento": 0.0,
        "ValorIGV": 0.18,
        "IdMSOrigen": 4,
        "IdOrigen": "0",
        "IdDetalleOrigen": "0",
        "ValorUnitario": 38.14,
        "Total": 45.0,
        "PrecioVentaItem": 45.0,
        "CodigoSunat": "",
        "TipoTributoTipo": "",
        "TipoTributoValor": "",
        "TipoTributoAuxiliar1": "",
        "TipoTributoAuxiliar2": "",
        "TipoTributoAuxiliar3": "",
        "TipoIgvIdParametro": 3,
        "TipoIgvIdDominio": 10,
        "TipoIgvTipo": "1",
        "TipoIgvValor": "",
        "TipoIgvAuxiliar2": "",
        "TipoIgvAuxiliar3": "clientes varios",
        "TipoIscTipo": "",
        "TipoIscValor": "",
        "TipoIscAuxiliar1": "",
        "TipoIscAuxiliar2": "",
        "TipoIscAuxiliar3": "",
        "TipoVentaIdParametro": 12,
        "TipoVentaIdDominio": 106,
        "TipoVentaTipo": "1",
        "TipoVentaValor": "",
        "TipoVentaAuxiliar2": "",
        "TipoVentaAuxiliar3": "clientes varios",
        "TipoCargoTipo": "",
        "TipoCargoValor": "",
        "TipoCargoAuxiliar1": "",
        "TipoCargoAuxiliar2": "",
        "TipoCargoAuxiliar3": "",
        "LogVersion": 0,
        "DescuentoVista": 0.0,
        "OtrosCargosItem": 0.0,
        "OtrosTributos": 0.0,
        "ICBPER": 0.0,
        "DescuentoPrecio": 0.0,
        "ListaParametros": [
          {
            "IdDetalleDocumento": 45643548,
            "IdDominio": 10,
            "IdParametro": 3,
            "Tipo": "1",
            "Valor": "",
            "Auxiliar2": "",
            "Auxiliar3": "clientes varios",
            "Id": 0,
            "LogUsuariocrea": "demo-api",
            "LogFechacrea": "2024-08-08T16:23:56.943",
            "LogUsuariomodif": "demo-api",
            "LogFechamodif": "2024-08-08T16:23:56.943",
            "LogEstado": 1
          },
          {
            "IdDetalleDocumento": 45643548,
            "IdDominio": 106,
            "IdParametro": 12,
            "Tipo": "1",
            "Valor": "",
            "Auxiliar2": "",
            "Auxiliar3": "clientes varios",
            "Id": 0,
            "LogUsuariocrea": "demo-api",
            "LogFechacrea": "2024-08-08T16:23:56.943",
            "LogUsuariomodif": "demo-api",
            "LogFechamodif": "2024-08-08T16:23:56.943",
            "LogEstado": 1
          }
        ],
        "Id": 45643548,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:56.943",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:56.943",
        "LogEstado": 1
      }
    ],
    "ListaConcepto": [
      {
        "IdDocumentoContable": 22159462,
        "IdConcepto": 1,
        "Monto": 63.56,
        "AuxiliarVarchar1": "",
        "AuxiliarVarchar2": "",
        "Id": 142464771,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:56.943",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:56.943",
        "LogEstado": 1
      },
      {
        "IdDocumentoContable": 22159462,
        "IdConcepto": 2,
        "Monto": 0.0,
        "AuxiliarVarchar1": "",
        "AuxiliarVarchar2": "",
        "Id": 142464772,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:56.943",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:56.943",
        "LogEstado": 1
      },
      {
        "IdDocumentoContable": 22159462,
        "IdConcepto": 3,
        "Monto": 0.0,
        "AuxiliarVarchar1": "",
        "AuxiliarVarchar2": "",
        "Id": 142464773,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:56.943",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:56.943",
        "LogEstado": 1
      },
      {
        "IdDocumentoContable": 22159462,
        "IdConcepto": 4,
        "Monto": 0.0,
        "AuxiliarVarchar1": "",
        "AuxiliarVarchar2": "",
        "Id": 142464774,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:56.943",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:56.943",
        "LogEstado": 1
      },
      {
        "IdDocumentoContable": 22159462,
        "IdConcepto": 12,
        "Monto": 0.0,
        "AuxiliarVarchar1": "",
        "AuxiliarVarchar2": "",
        "Id": 142464775,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:56.943",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:56.943",
        "LogEstado": 1
      },
      {
        "IdDocumentoContable": 22159462,
        "IdConcepto": 5,
        "Monto": 63.56,
        "AuxiliarVarchar1": "",
        "AuxiliarVarchar2": "",
        "Id": 142464776,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:56.943",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:56.943",
        "LogEstado": 1
      },
      {
        "IdDocumentoContable": 22159462,
        "IdConcepto": 10,
        "Monto": 0.0,
        "AuxiliarVarchar1": "",
        "AuxiliarVarchar2": "",
        "Id": 142464777,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:56.943",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:56.943",
        "LogEstado": 1
      },
      {
        "IdDocumentoContable": 22159462,
        "IdConcepto": 8,
        "Monto": 0.0,
        "AuxiliarVarchar1": "",
        "AuxiliarVarchar2": "",
        "Id": 142464778,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:56.943",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:56.943",
        "LogEstado": 1
      }
    ],
    "ListaEntidades": [
      {
        "IdComprobante": 22159462,
        "IdCliente": 1550521,
        "IdEntidad": 60005,
        "TipoEntidad": 2,
        "IdTipoDocumento": 2,
        "IdEntidadContable": 0,
        "TipoDocumentoDescripcion": "RUC",
        "NumeroDocumento": "10434365533",
        "RazonSocial": "ROSADO ROLDAN LUIS FERNANDO",
        "Direccion": "Av. El sol 105 - Paucarpata",
        "CorreoEntidadReceptor": "",
        "Id": 60014160,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:56.943",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:56.943",
        "LogEstado": 1
      },
      {
        "IdComprobante": 22159462,
        "IdEntidad": 1361941,
        "TipoEntidad": 1,
        "IdTipoDocumento": 2,
        "IdEntidadContable": 0,
        "NumeroDocumento": "00000000021",
        "RazonSocial": "EMPRESA DEMO API",
        "Direccion": "DIRECCION EMPRESA DEMO API",
        "CorreoEntidadReceptor": "",
        "Auxiliar1": "180148",
        "Auxiliar2": "3",
        "Id": 60014161,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:56.943",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:56.943",
        "LogEstado": 1
      },
      {
        "IdComprobante": 22159462,
        "IdEntidad": 1361941,
        "TipoEntidad": 3,
        "IdEntidadContable": 0,
        "TipoDocumentoDescripcion": "",
        "NumeroDocumento": "",
        "RazonSocial": "",
        "Direccion": "",
        "CorreoEntidadReceptor": "",
        "Auxiliar1": "",
        "Auxiliar2": "",
        "Auxiliar3": "",
        "Telefono": "",
        "Id": 60014162,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:57.403",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:57.403",
        "LogEstado": 1
      }
    ],
    "ListaAdicional": [],
    "ListaParametro": [],
    "ListaArchivos": [
      {
        "IdDocumentoContable": 22159462,
        "Archivo": "F801-00000022-1003-PDF.pdf",
        "TipoArchivo": 1,
        "RucEmisor": "00000000021",
        "LogVersion": 0,
        "Id": 59921782,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:58.313",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:58.313",
        "LogEstado": 1
      },
      {
        "IdDocumentoContable": 22159462,
        "Archivo": "F801-00000022-1003-VOUCHER.pdf",
        "TipoArchivo": 6,
        "RucEmisor": "00000000021",
        "LogVersion": 0,
        "Id": 59921783,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:23:58.317",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:23:58.317",
        "LogEstado": 1
      },
      {
        "IdDocumentoContable": 22159462,
        "Archivo": "F801-00000022-1003-XML.xml",
        "TipoArchivo": 2,
        "RucEmisor": "00000000021",
        "LogVersion": 0,
        "Id": 59921799,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:24:02.34",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:24:02.34",
        "LogEstado": 1
      },
      {
        "IdDocumentoContable": 22159462,
        "Archivo": "F801-00000022-1003-CDR.zip",
        "TipoArchivo": 3,
        "RucEmisor": "00000000021",
        "LogVersion": 0,
        "Id": 59921846,
        "LogUsuariocrea": "demo-api",
        "LogFechacrea": "2024-08-08T16:24:13.843",
        "LogUsuariomodif": "demo-api",
        "LogFechamodif": "2024-08-08T16:24:13.843",
        "LogEstado": 1
      }
    ],
    "ListaReferencias": [],
    "ListaRecibos": [],
    "ListaConductores": [],
    "ListaEventos": [],
    "Id": 22159462,
    "LogUsuariocrea": "demo-api",
    "LogFechacrea": "2024-08-08T16:23:56.92",
    "LogUsuariomodif": "demo-api",
    "LogFechamodif": "2024-08-08T16:24:13.83",
    "LogEstado": 1
  }
]
2. Ejemplo erróneoVer trama completa
Respuesta de error
{
  "IdError": 500,
  "Mensaje": "Error on FindDocumentosGeneradosPorMasivosQryHandler: No se encontró ningún documento con la información ingresada.",
  "Traza": ""
}

PDF, XML y CDR

API para descarga de archivos

Esta API sirve para descargar los archivos relacionados con la creación de los documentos contables, como facturas, boletas y notas de crédito o débito. Cuando se ejecuta correctamente retorna el nombre y un archivo serializado en Base64; cuando se ejecuta erróneamente muestra la causa.

GEThttps://erpperuapi.smartclic.pe/PuntoVenta/api/DocumentosContables/Archivos

Los resultados del uso de esta API se pueden observar en la página web del sistema. El manual enlaza el video de capacitación de búsqueda de documentos. Ver capacitación

III. Datos de entrada de la API

Parámetros de entrada

Query parameters
  • idComprobanteSí
    Tipo
    Numérico
    Longitud
    —

    Id del comprobante del cual se desea descargar un archivo. Se obtiene del campo Id al consultar un comprobante de manera exitosa.

  • tipoArchivoSí
    Tipo
    Numérico
    Longitud
    1

    Tipo de archivo: 1 PDF; 2 XML; 3 CDR.

IV. Tramas de ejemplo de datos de entrada

Ejemplos de entrada

1. Consulta de documentosVer trama
Petición HTTP
https://erpperuapi.smartclic.pe/PuntoVenta/api/DocumentosContables/Archivos?idComprobante=21491121&tipoArchivo=1

V. Datos de salida de la API

Campos de respuesta

Caso exitoso (campos más relevantes)
  • NombreSí
    Tipo
    Texto
    Longitud
    150

    Nombre del archivo.

  • Base64Sí
    Tipo
    Texto
    Longitud
    —

    Archivo serializado del documento.

  • NumeroDocumentoEmisorSí
    Tipo
    Texto
    Longitud
    11

    Número de documento del emisor.

Caso erróneo
  • IdErrorSí
    Tipo
    Numérico
    Longitud
    —

    Código del error.

  • MensajeSí
    Tipo
    Texto
    Longitud
    —

    Descripción del error.

  • TrazaSí
    Tipo
    Texto
    Longitud
    —

    Información más detallada del error en el sistema.

VI. Tramas de ejemplo de datos de salida

Ejemplos de salida

1. Ejemplo exitosoVer trama completa
Respuesta exitosa
{
  "Nombre": "00000000021/V069-00000017-3008-PDF.pdf",
  "Base64": "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qblAYhbM+f3beqQoDm9uMDLpP+7b2WlORNQ5KI0Zs8zMUDz9Rxo3NcixZlyiV6/fUOaqA57Szbbkz6cT6YfeDKdf6qR0szQD6dQ+avJv7hSIlG67fZOkap/pEI75b3vfHgF99Z1OUmo1g7Ruf5vaC9VSu21mvx3XHT/F7VMsTe2ZZS4hJBrkoNWXFBjTCl9+hEzCAVx2wO2Zbon25+DcXhMpBzm5ATdwu5tbokFO7DDsYaRxu8fhwuD2TDeRxC1opWZ0eBK3KxaRHgNu4HY3t0SDnDscQvvqARy4PdMt0cD7Fidav3mQA27PdEt0cCbN7SVJ4wYD79SA2zPd0px4CgPv1IDbM93SbO24YtftMWkGOeFH+8QkiVuayD7epHATt5guiT047TnnjOR2mkFnVOQCTUpprcK73Q73fSuTCZt2QPuHb8qEbctp9ziTPab9cpOJPC5oCkR3k6oAALagilo5FfUrO/rEV3utiXKnMJjjDVkRIkdlwtIymESNvHchTnOyJ6K15cSpC32PGR9vHIrkXUag3ji53WPmwBv24jLpNKxLG2czGU4BOlDuVAbiEDPgHhM+IfwNdP8atSmmBv8BQ7nTB/yfEMvoLXe6ImCdA3toq21iryQfO3ZbsLvh3Ek7zZvd7M03yp200zCb2j3e1Z/COrNAcqcsApZG4AVNwMdSKq/cXZ+SnUkh9hI1FdDcpEG5UwQAAAAAgEafaraaJGE783fmz2v9S/fqq5QYVzFC6q860XrBDcmySAWN2dLEjqpvoZ9EfY4EDrci1H5wYFoEbyynqsSgZJm0vvQtTqOWW0yR5OX/0UKYa+CJKtNiczLN1XQs8TKpcjrFll8sNdaVFU6qtXHE6hRakcanV2t9q28wyEyg+WAcSlvd8XBu/fpVV0X2UZ73pqB49MpeAAAAAAAAAAAAAAAA4G78AyKiGC8KZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgMTEKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDA1MjEwIDAwMDAwIG4gCjAwMDAwMDU1OTQgMDAwMDAgbiAKMDAwMDAwNTI1NSAwMDAwMCBuIAowMDAwMDA1MDM2IDAwMDAwIG4gCjAwMDAwMDAwMTUgMDAwMDAgbiAKMDAwMDAwNTQxMyAwMDAwMCBuIAowMDAwMDA1NTA2IDAwMDAwIG4gCjAwMDAwMDU2NDUgMDAwMDAgbiAKMDAwMDAwOTExMyAwMDAwMCBuIAowMDAwMDA5NjI1IDAwMDAwIG4gCnRyYWlsZXIKPDwvSUQgWzxmOTBiZjlmZjVkNmQ2NGY2Zjk5YzFiYTI0Y2M1Y2I1ZT48ZjkwYmY5ZmY1ZDZkNjRmNmY5OWMxYmEyNGNjNWNiNWU+XS9JbmZvIDMgMCBSL1Jvb3QgMSAwIFIvU2l6ZSAxMT4+CiVpVGV4dC03LjEuMTQgZm9yIC5ORVQKc3RhcnR4cmVmCjEyNDI4CiUlRU9GCg==",
  "NumeroDocumentoEmisor": "00000000021"
}
2. Ejemplo erróneoVer trama completa
Respuesta de error
{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.6.1",
  "title": "An error occurred while processing your request.",
  "status": 500,
  "traceId": "00-dc8e2148c26c959c561aed076dba8b34-c59cfd1a4ec224dc-01"
}

Diagnóstico

Catálogo de errores

Filtra por familia, código o descripción. El campo exacto y la línea afectada llegan en la respuesta del endpoint cuando aplican.

0001

La serie está vacía.

0002

La serie no cumple el formato requerido.

0003

El correlativo está vacío.

0004

El correlativo no cumple el formato requerido.

0005

El campo es incorrecto o no existe.

0006

El código del producto está vacío.

0007

La serie no existe o el tipo de serie es automático.

0008

El correlativo está repetido en el archivo.

0009

La fecha de emisión no cumple el formato requerido.

0010

La fecha de emisión está vacía.

0011

La moneda no cumple el formato requerido.

0012

La moneda está vacía.

0013

La condición de pago no cumple el formato requerido.

0014

La condición de pago está vacía.

0015

El tipo de documento del receptor no cumple el formato requerido.

0016

El tipo de documento del receptor está vacío.

0017

El número de documento del receptor no cumple el formato requerido.

0018

El número de documento del receptor está vacío.

0019

La observación debe tener máximo 200 caracteres.

0020

Las operaciones gravadas no cumplen el formato requerido.

0021

Las operaciones gravadas están vacías.

0022

Las operaciones inafectas no cumplen el formato requerido.

0023

Las operaciones inafectas están vacías.

0024

Las operaciones exoneradas no cumplen el formato requerido.

0025

Las operaciones exoneradas están vacías.

0026

Las operaciones gratuitas no cumplen el formato requerido.

0027

Las operaciones gratuitas están vacías.

0028

El total de descuentos por ítem no cumple el formato requerido.

0029

El total de descuentos por ítem está vacío.

0030

El descuento global no cumple el formato requerido.

0031

El descuento global está vacío.

0032

El total del IGV no cumple el formato requerido.

0033

El total del IGV está vacío.

0034

El total de otros tributos no cumple el formato requerido.

0035

El total de otros tributos está vacío.

0036

El total de otros cargos no cumple el formato requerido.

0037

El total de otros cargos está vacío.

0038

El subtotal no cumple el formato requerido.

0046

La cantidad del ítem no cumple con el formato requerido.

0049

La descripción del producto debe tener máximo 500 caracteres.

0077

El correlativo del documento ya existe.

0144

El campo fecha de vencimiento no cumple con el formato requerido.

0145

El campo Icbper no cumple el formato requerido.

0146

El campo TotalIcbper no cumple el formato requerido.

0147

El campo Cuotas no cumple el formato requerido (Fecha|Monto).

0148

Si la condición de pago es crédito se debe enviar el campo Cuotas.

0149

Si la condición de pago es contado no se debe enviar el campo Cuotas.

0150

El campo Detracción no cumple con el formato requerido.

0151

Los campos de Detracción están incompletos.

0152

Los campos de Detracción están incompletos.

50 resultados en facturas y boletas

Valores permitidos

Dominios

Usa estos códigos en los campos que esperan valores controlados. Respeta mayúsculas, formato y tipo de dato.

Moneda2 valores
PENSol peruano
USDDólar estadounidense
Condición de pago2 valores
1Contado
2Crédito
Tipos de identidad4 valores
DNIDocumento Nacional de Identidad
RUCRegistro Único de Contribuyentes
PASAPORTEPasaporte
CARNETDEEXTRANJERIACarné de extranjería
Tipos de documento4 valores
01Factura
03Boleta de venta
07Nota de crédito
08Nota de débito
Tipos de nota10 valores
31Anulación de la operación
32Anulación por error en el RUC
33Corrección por error en la descripción
34Descuento global
35Descuento por ítem
36Devolución total
37Devolución por ítem
41Intereses por mora
42Aumento en el valor
43Penalidades u otros conceptos
Cargos y descuentos12 valores
02Descuento global que afecta la base imponible del IGV/IVAP
03Descuento global que no afecta la base imponible del IGV/IVAP
04Descuento global por anticipo gravado
05Descuento global por anticipo exonerado
06Descuento global por anticipo inafecto
45Cargo FISE
46Recargo al consumo y/o propinas
49Cargo global que afecta la base imponible del IGV/IVAP
50Cargo global que no afecta la base imponible del IGV/IVAP
51Percepción por venta interna
52Percepción por adquisición de combustible
53Percepción realizada al agente de percepción con tasa especial
Afectación al IGV18 valores
10Gravado - operación onerosa
11Gravado - retiro por premio
12Gravado - retiro por donación
13Gravado - retiro
14Gravado - retiro por publicidad
15Gravado - bonificaciones
16Gravado - retiro por entrega a trabajadores
17Gravado - IVAP
20Exonerado - operación onerosa
21Exonerado - transferencia gratuita
30Inafecto - operación onerosa
31Inafecto - retiro por bonificación
32Inafecto - retiro
33Inafecto - retiro por muestras médicas
34Inafecto - retiro por convenio colectivo
35Inafecto - retiro por premio
36Inafecto - retiro por publicidad
40Exportación
Unidades de medida28 valores
NIUUnidad
KGMKilogramo
LTRLitro
MTRMetro
MTKMetro cuadrado
MTQMetro cúbico
DZNDocena
PKPaquete
BXCaja
BGBolsa
BOBotella
BLLBarril
ONZOnza
CENCiento
CYCilindro
CJConos
CALatas
STNTonelada corta
LTNTonelada larga
4ABobina
BJBalde
BEFardo
FOTPie
FTKPie cuadrado
FTQPie cúbico
CMKCentímetro cuadrado
CMQCentímetro cúbico
CMTCentímetro
Tipos de guía2 valores
REMITENTEGuía de remisión remitente
TRANSPORTISTAGuía de remisión transportista
Motivos de traslado9 valores
01Venta
02Compra
04Traslado entre establecimientos de la misma empresa
18Traslado por emisor itinerante de comprobantes
19Traslado a zona primaria
08Importación
13Otros
14Venta sujeta a confirmación del comprador / consignación según el manual
09Exportación
Modalidad de traslado2 valores
01Transporte público
02Transporte privado
Tipos de archivo3 valores
1PDF
2XML
3CDR
Creación de entidad2 valores
1Buscar entidad en SUNAT/RENIEC
0Agregar entidad manualmente
Medios de pago de detracción22 valores
001Depósito en cuenta
002Giro
003Transferencia de fondos
004Orden de pago
005Tarjeta de débito
006Tarjeta de crédito emitida por el sistema financiero
007Cheque con cláusula no negociable
008Efectivo sin obligación de usar medio de pago
009Efectivo en los demás casos
010Medios de pago usados en comercio exterior
011Documentos emitidos por EDPYMES y cooperativas
012Tarjeta emitida por empresa no perteneciente al sistema financiero
013Tarjeta emitida en el exterior por empresa financiera no domiciliada
101Transferencias - comercio exterior
102Cheques bancarios - comercio exterior
103Orden de pago simple - comercio exterior
104Orden de pago documentario - comercio exterior
105Remesa simple - comercio exterior
106Remesa documentaria - comercio exterior
107Carta de crédito simple - comercio exterior
108Carta de crédito documentario - comercio exterior
999Otros medios de pago
Bienes y servicios sujetos a detracción37 valores
001Azúcar y melaza de caña
002Arroz
003Alcohol etílico
004Recursos hidrobiológicos
005Maíz amarillo duro
007Caña de azúcar
008Madera
009Arena y piedra
010Residuos, subproductos, desechos, recortes y desperdicios
011Bienes gravados con IGV o renuncia a la exoneración
012Intermediación laboral y tercerización
013Animales vivos
014Carnes y despojos comestibles
015Abonos, cueros y pieles de origen animal
016Aceite de pescado
017Harina, polvo y pellets de pescado y otros invertebrados acuáticos
019Arrendamiento de bienes muebles
020Mantenimiento y reparación de bienes muebles
021Movimiento de carga
022Otros servicios empresariales
023Leche
024Comisión mercantil
025Fabricación de bienes por encargo
026Servicio de transporte de personas
027Servicio de transporte de carga
028Transporte de pasajeros
030Contratos de construcción
031Oro gravado con IGV
032Páprika y otros frutos de los géneros capsicum o pimienta
034Minerales metálicos no auríferos
035Bienes exonerados del IGV
036Oro y demás minerales metálicos exonerados del IGV
037Demás servicios gravados con el IGV
039Minerales no metálicos
040Bien inmueble gravado con IGV
041Plomo
099Ley 30737
Entidades emisoras de autorización12 valores
01SUCAMEC
02Dirección General de Medicamentos, Insumos y Drogas
03Dirección General de Salud Ambiental
04Servicio Nacional de Sanidad Agraria
05Servicio Nacional Forestal y de Fauna Silvestre
06Ministerio de Transportes y Comunicaciones
07Ministerio de la Producción
08Ministerio del Ambiente
09Organismo Nacional de Sanidad Pesquera
10Municipalidad Metropolitana de Lima
11Ministerio de Salud
12Gobierno Regional
Indicadores de retorno3 valores
SUNAT_Envio_IndicadorRetornoVehiculoEnvaseVacioRetorno de vehículo con envases o embalajes vacíos
SUNAT_Envio_IndicadorRetornoVehiculoVacioRetorno de vehículo vacío
SUNAT_Envio_IndicadorTransporteSubcontratadoTransporte subcontratado
Pagador del flete3 valores
SUNAT_Envio_IndicadorPagadorFlete_RemitenteRemitente
SUNAT_Envio_IndicadorPagadorFlete_SubcontratadorSubcontratador
SUNAT_Envio_IndicadorPagadorFlete_TerceroOtros (terceros)

Referencia del documento

Series utilizadas en el manual

Estas series identifican los ejemplos del manual. No implican que estén asignadas automáticamente a tu cuenta.

FacturaF801
Boleta de ventaB801
Nota de crédito de facturaF810
Nota de crédito de boletaB810
Nota de débito de facturaF820
Nota de débito de boletaB820
Guía de remisión remitenteT013
Guía de remisión transportistaV069

Referencia elaborada a partir del manual SmartClic API v2.0, fechado el 05/08/2024. Para solicitar credenciales o confirmar una configuración de producción, comunícate con el equipo de SmartClic.

Acceso para clientes

¿A qué versión de SmartClic quieres ingresar?

Elige tu versión según la fecha en que te convertiste en cliente.

Vista de acceso de SmartClic versión 1SmartClic versión 1Para clientes anteriores al 4 de agosto de 2026.Vista de acceso de SmartClic versión 2SmartClic versión 2Para clientes posteriores al 4 de agosto de 2026.