RAPIFAC
DOCS
RAPIFAC
DOCS

Introducción

El presente documento tiene por finalidad facilitar la integración de las empresas, en la utilización y consumo de la API REST RAPIFAC para la emisión electrónica de comprobantes de pago, así mismo facilitar la autorización de DICHA API, vía nuestro nuevo servidor de autorización que sigue los estándares OAuth2.0.


Antes de empezar

Antes de empezar a consumir la API REST RAPIFAC, tenga en cuenta que debe comunicarse con el área de ventas de nuestra empresa, con el fin de que se le otorgue un usuario y contraseña para poder hacer uso de nuestra plataforma.

La ubicación de ambiente:
Ambiente de pruebasAmbiente de producción
Autentificaciónwsoauth-exp.rapifac.comwsoauth.rapifac.com
Emisiónwsventas-exp.rapifac.comwsventas.rapifac.com
Comprobanteswscomprobante-exp.rapifac.comwscomprobante.rapifac.com

Autentificación

Autorización

Para poder empezar a consumir nuestra API, primero deberá solicitar un token de acceso (access_token), este le permitirá por un tiempo limitado tener acceso a los endpoints de nuestra API, cabe señalar que este token solo le dará acceso a los recursos de emisión electrónica a los que tenga permiso y que correspondan únicamente a su empresa; por otro lado el servidor de autorización le otorgará un token de refresco (refresh_token), con esté, podrá solicitar un nuevo token de acceso cuando el que tenga haya expirado y no pueda utilizarse más; todo el flujo de autorización, obtención de token de acceso y token de refresco se implementa siguiendo los estándares OAuth2.0. A continuación se muestra el flujo de autorización de nuestro servicio de integración:

RAPIFAC

Para el flujo de autorización tendremos los siguientes endpoints y sus respectivos parámetros:


1. Access token vía resource owner credentials
GET
https://wsoauth-exp.rapifac.com

Los campos username y password deben ser llenados con las credenciales correspondientes, por ejemplo si mi DNI es 55555555 y mi ruc 20555555551 el campo username=5555555520555555551 y el campo password será la contraseña correspondiente al usuario.

Si la respuesta nos da un status code 200, entonces será exitosa y tendremos una respuesta como la siguiente:

Si el resultado de la petición retorna un status code 400, quiere decir que ud. ha enviado algún dato o parámetro de manera incorrecta, mostrando como respuesta:

2. Access token vía refresh token
GET
https://wsoauth-exp.rapifac.com

El campo refresh_token debe ser completado con los datos del refresh token obtenido, cuando se obtuvo el access_token anterior.

Si la respuesta a la petición contiene un status code 200 entonces se obtendrá una respuesta igual a la de la petición de token vía Resource Owner Credentials, de igual manera si la respuesta contiene un status code 400 la respuesta será similar a la anterior mostrada.

Una vez que se obtiene el token de acceso todas las llamadas a la API REST RAPIFAC deberán llevar una cabecera llamada Authorization esta cabecera deberá contener el token_type obtenido en la solicitud de token, un espacio y el access_token que también se obtuvo de la petición de autorización; un ejemplo de solicitud con la cabecera de autorización sería el siguiente:

GET
https://wsventas-exp.rapifac.com/v0/comprobantes

A continuación; se muestran ejemplos en distintos lenguajes y tecnologías utilizadas.

POST
https://wsoauth-exp.rapifac.com/oauth2/token


Emisión

1. Emisión de un comprobante

Estas líneas de código están enviando una solicitud de acceso a nuestro servidor web de RAPIFAC para poder Emitir un Comprobante Electrónico, utilizando un token de autenticación proporcionado en el Inicio de Sesión en formato JWT y enviando un objeto JSON con detalles relevantes para la solicitud.

POST
https://wsventas-exp.rapifac.com/v0/comprobantes




2. Objeto para la emisión de un comprobante

Los datos se envían en formato JSON. Los datos necesarios son:




3. Descripción de los elementos del objeto
campotipoValor Ejemplodescripción
IDNumber123Este valor es el identificador del comprobante y se genera automáticamente por NUESTRO SISTEMA en el momento de la emisión del comprobante.
Sucursalint1El id que identifica a la sucursal para la cual se está emitiendo el comprobante
IGVPorcentajeDecimal18Porcentaje que se aplicará a la venta (los restaurantes pueden solicitar que sea 10)
DescuentoGlobalMontoDecimal8.47Descuento Global en monto pero el valor neto de los productos gravados
CargoGlobalPorcentajeDecimal0El porcentaje de descuento de los productos
CargoGlobalIndicadorCargosBooltrueIndicador para el XML que se enviara a la SUNAT
CargoGlobalCodigoMotivostring46Recargo al consumo y/o propinas
CondicionPagostringContadoCondición en la cual se realiza el pago del comprobante, sus valores pueden ser: Contado, Credito.
ClienteTipoDocIdentidadCodigostring6Cadena que representa el tipo de documento de identidad del cliente del comprobante, los valores que este campo puede aceptar son los siguientes: - -: SN DOC.DOM - 0: DOC. TRIB. - 1: L.E/DNI - 4: CARNET EXT - 6: RUC - 7: PASAPORTE - 9: CARNÉ SOLIC. REFUGIO - A: CED. DIPL. - B: DOC. PAIS RESID. - C: DOC TIN - PP.NN - D: DOC IN - PP.JJ - E: TARJETA ANDINA - TAM - F: PERMISO TEMPORAL - PTP - G: SALVOCONDUCTO - I: CARNÉ C.IDENT.-RREE - J: DOC.ID.EXTR. Sin embargo, estos tipos serán válidos para ciertos comprobantes y para ciertos casos, estos son: - TipoDocumentoCodigo 01, operación 0101: 6 - TipoDocumentoCodigo 01, TipoOperacionCodigo 0101: 6 - TipoDocumentoCodigo 01, TipoOperacionCodigo 0200: 0, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0201: 0, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0202: 0, 6, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0205: 7, B - TipoDocumentoCodigo 01, TipoOperacionCodigo 2001: 6 - TipoDocumentoCodigo 03, Todos los tipos de documento
ClienteNumeroDocIdentidadstring20200200201El número del documento de identidad del cliente a quién se emite el comprobante
ListaDetallesArray[ ComprobanteDetalle1, ComprobanteDetalle2 ]La lista de detalles del comprobante, cada ítem del arreglo será del tipo DetalleComprobante que se detallará más adelante.
ExoneradaXMLDecimal0Total(sumatoria) del valor de venta neto de los productos exonerados
InafectoXMLDecimal0Total(sumatoria) del valor de venta neto de los productos inafectos
ExportacionXMLDecimal0Total(sumatoria) del valor de venta neto de los productos de exportación
ImporteTotalTextostringVEINTE CON 00/100 SOLESImporte total del comprobante en texto
DescuentoGlobalMontoBaseDecimal16.949Valor Neto de la venta de los productos gravados
DescuentoGlobalNGMontoDecimal0Descuento Global en monto pero el valor neto de los productos no gravados
DescuentoGlobalNGMontoBaseDecimal0Valor Neto de la venta de los productos no gravados
AnticiposGravadoDecimal0Valor neto del Anticipo Gravado
AnticiposExoneradoDecimal0Valor neto del Anticipo Exonerado
AnticiposInafectoDecimal0Valor neto del Anticipo Inafecto
CargoGlobalMontoDecimal0Recargo Global en monto pero el valor neto
CargoGlobalMontoBaseDecimal10.00Valor Neto de la venta de los productos
ISCBaseDecimal0Sumatoria del ValorVentaItemXML
GratuitoGravadoDecimal10Total(sumatoria) del valor de venta neto de los productos
TotalPrecioVentaDecimal10Total precio de venta (subtotal de la factura)
TotalValorVentaDecimal8.47457Total valor de venta
ListaMovimientosArray[ MovimientoCuenta1, MovimientoCuenta2]Arreglo de objetos de movimientos de cuentas, este objeto se detallará más adelante.
CreditoTotalDecimal10Total de crédito del comprobante
TipoDocumentoCodigostring01Tipo de comprobante para la emisión lo valores posibles pueden ser: -01: FACTURA -03: BOLETA -07: NOTA DE CRÉDITO -08: NOTA DE DÉBITO -09: GUÍA REMITENTE -31: GUÍA TRANSPORTISTA -98: COTIZACIÓN -99: ORDEN
SeriestringF001Serie del documento o comprobante
Correlativoint0001Número correlativo del documento o comprobante
MonedaCodigostringPENCódigo de la moneda con la que se emitió el comprobante: PEN y USD
FechaEmisionstring30/05/2022Cadena con la fecha de emisión del comprobante, esta fecha debe estar en el formato dd/mm/yyyy, esta fecha debe ser la misma fecha en la que se emite el comprobante.
CorrelativoModificadostring156Correlativo que se modifica cuando el comprobante que se emite es de tipo 07 o 08
TipoNotaCreditoCodigostring01Valor que identifica el tipo de nota de crédito, aplica si el comprobante es de tipo 07. - 01: Anulación de la operación - 03: Corrección por error en la descripción - 04: Descuento global - 06: Devolución total - 07: Devolución por ítem - 13: Ajustes – montos y/o fechas de pago
TipoNotaDebitoCodigostring01Valor que identifica el tipo de nota de débito, este valor solo aplica cuando el comprobante es de tipo 08. - 01: INTERESES POR MORA - 02: AUMENTO EN EL VALOR - 03: PENALIDAD
TipoOperacionCodigostring0101Este código sirve para identificar el tipo de operación a realizar y aplica al comprobante tipo 01 Factura, sus posibles valores pueden ser: - 0101: Venta interna - 0200: Exportación de Bienes - 0201: Exportación de Servicios – Prestación servicios realizados íntegramente en el país - 0202: Exportación de Servicios – Hospedaje No Domiciliado - 0205: Exportación de Servicios – Paquete Turístico - 1001: Operación Sujeta a Detracción - 2001: Operación Sujeta a Percepción Para el comprobante tipo 03 Boleta su valor debe ser 0101.
TipoCambioNumber3.78El tipo de cambio del dólar
ClienteNombreRazonSocialstringLibertad S.A.Razón social del cliente a quién se emite el comprobante.
ClienteDireccionstringAv. Siempre Viva 666Dirección del cliente a quién se emite el comprobante.
DescuentoGlobalPorcentajeDecimal50El porcentaje de descuento de los productos gravados
DescuentoGlobalValorDecimal10Descuento global como monto de los productos gravados
ObservacionstringRegularización del anticipoCampo que sirve para agregar una observación adicional al comprobante
GravadoDecimal8.4745Total(sumatoria) del valor de venta de los productos gravados
ExoneradaDecimal0Total(sumatoria) del valor de venta de los productos exonerados
TipoDocumentoCodigoModificadoString01Valor que representa el tipo de documento que se modifica, aplica en caso de que el comprobante sea de tipo 07 o 08, ya que estos documentos son de modificación de comprobantes, los valores posibles que puede contener son: - 01: FACTURA - 03: BOLETA DE VENTA
SerieModificadoStringF001Serie del documento que se modifica cuando el comprobante que se emite es del tipo 07 o 08.
InafectoDecimal0Total(sumatoria) del valor de venta de los productos inafectos
ExportacionDecimal0Total(sumatoria) del valor de venta de los productos exportación
GratuitoDecimal0Total(sumatoria) del valor de venta de los productos gratuitos no gravados
TotalDescuentosDecimal8.47457Total de los descuentos tanto global como descuento por ítem
TotalAnticiposDecimal0Total de todos los anticipos
ISCdecimal39.996399Monto calculado después de ingresar el ISCPorcentaje
IGVDecimal1.525Suma IGV de todos los ítems
ICBPERDecimal0Total del Impuesto al consumo de las bolsas de plástico
ImpuestoTotalDecimal1.525Total de los impuestos a pagar (IGV, ISC, ICBPER, etc)
TotalOtrosCargosDecimal1.525Total de los otros cargos
TotalImporteVentaDecimal10Importe total de la venta, cesión en uso o del servicio prestado
TotalPagoDecimal10Total a pagar
PendientePagoDecimal10Total pendiente de pago

Factura

Objeto para la emisión de una Factura

Para la factura se utiliza el objeto comprobante, este objeto a diferencia de los demás; tiene por datos específicos para la emisión de este comprobante.




Respuesta de la petición

El tipo de respuesta es un json y tendremos una respuesta con datos del XML y/o CDR como la siguiente:




Descripción de los elementos del objeto
campotipoValor Ejemplodescripción
IDNumber123Este valor es el identificador del comprobante y se genera automáticamente por NUESTRO SISTEMA en el momento de la emisión del comprobante.
Sucursalint1El id que identifica a la sucursal para la cual se está emitiendo el comprobante
IGVPorcentajeDecimal18Porcentaje que se aplicará a la venta (los restaurantes pueden solicitar que sea 10)
DescuentoGlobalMontoDecimal8.47Descuento Global en monto pero el valor neto de los productos gravados
CargoGlobalPorcentajeDecimal0El porcentaje de descuento de los productos
CargoGlobalIndicadorCargosBooltrueIndicador para el XML que se enviara a la SUNAT
CargoGlobalCodigoMotivostring46Recargo al consumo y/o propinas
CondicionPagostringContadoCondición en la cual se realiza el pago del comprobante, sus valores pueden ser: Contado, Credito.
ClienteTipoDocIdentidadCodigostring6Cadena que representa el tipo de documento de identidad del cliente del comprobante, los valores que este campo puede aceptar son los siguientes: - -: SN DOC.DOM - 0: DOC. TRIB. - 1: L.E/DNI - 4: CARNET EXT - 6: RUC - 7: PASAPORTE - 9: CARNÉ SOLIC. REFUGIO - A: CED. DIPL. - B: DOC. PAIS RESID. - C: DOC TIN - PP.NN - D: DOC IN - PP.JJ - E: TARJETA ANDINA - TAM - F: PERMISO TEMPORAL - PTP - G: SALVOCONDUCTO - I: CARNÉ C.IDENT.-RREE - J: DOC.ID.EXTR. Sin embargo, estos tipos serán válidos para ciertos comprobantes y para ciertos casos, estos son: - TipoDocumentoCodigo 01, operación 0101: 6 - TipoDocumentoCodigo 01, TipoOperacionCodigo 0101: 6 - TipoDocumentoCodigo 01, TipoOperacionCodigo 0200: 0, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0201: 0, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0202: 0, 6, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0205: 7, B - TipoDocumentoCodigo 01, TipoOperacionCodigo 2001: 6 - TipoDocumentoCodigo 03, Todos los tipos de documento
ClienteNumeroDocIdentidadstring20200200201El número del documento de identidad del cliente a quién se emite el comprobante
ListaDetallesArray[ ComprobanteDetalle1, ComprobanteDetalle2 ]La lista de detalles del comprobante, cada ítem del arreglo será del tipo DetalleComprobante que se detallará más adelante.
ExoneradaXMLDecimal0Total(sumatoria) del valor de venta neto de los productos exonerados
InafectoXMLDecimal0Total(sumatoria) del valor de venta neto de los productos inafectos
ExportacionXMLDecimal0Total(sumatoria) del valor de venta neto de los productos de exportación
ImporteTotalTextostringVEINTE CON 00/100 SOLESImporte total del comprobante en texto
DescuentoGlobalMontoBaseDecimal16.949Valor Neto de la venta de los productos gravados
DescuentoGlobalNGMontoDecimal0Descuento Global en monto pero el valor neto de los productos no gravados
DescuentoGlobalNGMontoBaseDecimal0Valor Neto de la venta de los productos no gravados
AnticiposGravadoDecimal0Valor neto del Anticipo Gravado
AnticiposExoneradoDecimal0Valor neto del Anticipo Exonerado
AnticiposInafectoDecimal0Valor neto del Anticipo Inafecto
CargoGlobalMontoDecimal0Recargo Global en monto pero el valor neto
CargoGlobalMontoBaseDecimal10.00Valor Neto de la venta de los productos
ISCBaseDecimal0Sumatoria del ValorVentaItemXML
GratuitoGravadoDecimal10Total(sumatoria) del valor de venta neto de los productos
TotalPrecioVentaDecimal10Total precio de venta (subtotal de la factura)
TotalValorVentaDecimal8.47457Total valor de venta
ListaMovimientosArray[ MovimientoCuenta1, MovimientoCuenta2]Arreglo de objetos de movimientos de cuentas, este objeto se detallará más adelante.
CreditoTotalDecimal10Total de crédito del comprobante
TipoDocumentoCodigostring01Tipo de comprobante para la emisión lo valores posibles pueden ser: -01: FACTURA -03: BOLETA -07: NOTA DE CRÉDITO -08: NOTA DE DÉBITO -09: GUÍA REMITENTE -31: GUÍA TRANSPORTISTA -98: COTIZACIÓN -99: ORDEN
SeriestringF001Serie del documento o comprobante
Correlativoint0001Número correlativo del documento o comprobante
MonedaCodigostringPENCódigo de la moneda con la que se emitió el comprobante: PEN y USD
FechaEmisionstring30/05/2022Cadena con la fecha de emisión del comprobante, esta fecha debe estar en el formato dd/mm/yyyy, esta fecha debe ser la misma fecha en la que se emite el comprobante.
CorrelativoModificadostring156Correlativo que se modifica cuando el comprobante que se emite es de tipo 07 o 08
TipoNotaCreditoCodigostring01Valor que identifica el tipo de nota de crédito, aplica si el comprobante es de tipo 07. - 01: Anulación de la operación - 03: Corrección por error en la descripción - 04: Descuento global - 06: Devolución total - 07: Devolución por ítem - 13: Ajustes – montos y/o fechas de pago
TipoNotaDebitoCodigostring01Valor que identifica el tipo de nota de débito, este valor solo aplica cuando el comprobante es de tipo 08. - 01: INTERESES POR MORA - 02: AUMENTO EN EL VALOR - 03: PENALIDAD
TipoOperacionCodigostring0101Este código sirve para identificar el tipo de operación a realizar y aplica al comprobante tipo 01 Factura, sus posibles valores pueden ser: - 0101: Venta interna - 0200: Exportación de Bienes - 0201: Exportación de Servicios – Prestación servicios realizados íntegramente en el país - 0202: Exportación de Servicios – Hospedaje No Domiciliado - 0205: Exportación de Servicios – Paquete Turístico - 1001: Operación Sujeta a Detracción - 2001: Operación Sujeta a Percepción Para el comprobante tipo 03 Boleta su valor debe ser 0101.
TipoCambioNumber3.78El tipo de cambio del dólar
ClienteNombreRazonSocialstringLibertad S.A.Razón social del cliente a quién se emite el comprobante.
ClienteDireccionstringAv. Siempre Viva 666Dirección del cliente a quién se emite el comprobante.
DescuentoGlobalPorcentajeDecimal50El porcentaje de descuento de los productos gravados
DescuentoGlobalValorDecimal10Descuento global como monto de los productos gravados
ObservacionstringRegularización del anticipoCampo que sirve para agregar una observación adicional al comprobante
GravadoDecimal8.4745Total(sumatoria) del valor de venta de los productos gravados
ExoneradaDecimal0Total(sumatoria) del valor de venta de los productos exonerados
InafectoDecimal0Total(sumatoria) del valor de venta de los productos inafectos
ExportacionDecimal0Total(sumatoria) del valor de venta de los productos exportación
GratuitoDecimal0Total(sumatoria) del valor de venta de los productos gratuitos no gravados
TotalDescuentosDecimal8.47457Total de los descuentos tanto global como descuento por ítem
TotalAnticiposDecimal0Total de todos los anticipos
ISCdecimal39.996399Monto calculado después de ingresar el ISCPorcentaje
IGVDecimal1.525Suma IGV de todos los ítems
ICBPERDecimal0Total del Impuesto al consumo de las bolsas de plástico
ImpuestoTotalDecimal1.525Total de los impuestos a pagar (IGV, ISC, ICBPER, etc)
TotalOtrosCargosDecimal1.525Total de los otros cargos
TotalImporteVentaDecimal10Importe total de la venta, cesión en uso o del servicio prestado
TotalPagoDecimal10Total a pagar
PendientePagoDecimal10Total pendiente de pago

Boleta

Objeto para la emisión de una Boleta

Para la emisión de una boleta se utiliza el objeto comprobante, este objeto a diferencia de los demás; tiene por datos específicos para la emisión de este comprobante.




Respuesta de la petición

El tipo de respuesta es un json y tendremos una respuesta con datos del XML y/o CDR como la siguiente:




Descripción de los elementos del objeto
campotipoValor Ejemplodescripción
UsuarioString20190306Código del usuario que emitió el comprobante
SucursalString3677El id que identifica a la sucursal para la cual se está emitiendo el comprobante
IGVPorcentajeDecimal18Porcentaje que se aplicará a la venta (los restaurantes pueden solicitar que sea 10)
DescuentoGlobalMontoDecimal0Descuento Global en monto pero el valor neto de los productos gravados
CargoGlobalIndicadorCargosString0.000000Indicador para el XML que se enviara a la SUNAT
CargoGlobalPorcentajeDecimal0El porcentaje de descuento de los productos
CargoGlobalCodigoMotivoString0Recargo al consumo y/o propinas
OrigenSistemaInt7Origen del sistema
CanalVentaString2Canal de venta
VendedorString20190306Identificador del vendedor
CondicionPagoStringContadoCondición en la cual se realiza el pago del comprobante, sus valores pueden ser: Contado, Credito.
UbigeoString150115Código de ubigeo del cliente a quién se emite el comprobante.
ClienteTipoDocIdentidadCodigoString6Cadena que representa el tipo de documento de identidad del cliente del comprobante, los valores que este campo puede aceptar son los siguientes: - -: SN DOC.DOM - 0: DOC. TRIB. - 1: L.E/DNI - 4: CARNET EXT - 6: RUC - 7: PASAPORTE - 9: CARNÉ SOLIC. REFUGIO - A: CED. DIPL. - B: DOC. PAIS RESID. - C: DOC TIN - PP.NN - D: DOC IN - PP.JJ - E: TARJETA ANDINA - TAM - F: PERMISO TEMPORAL - PTP - G: SALVOCONDUCTO - I: CARNÉ C.IDENT.-RREE - J: DOC.ID.EXTR. Sin embargo, estos tipos serán válidos para ciertos comprobantes y para ciertos casos, estos son: - TipoDocumentoCodigo 01, operación 0101: 6 - TipoDocumentoCodigo 01, TipoOperacionCodigo 0101: 6 - TipoDocumentoCodigo 01, TipoOperacionCodigo 0200: 0, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0201: 0, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0202: 0, 6, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0205: 7, B - TipoDocumentoCodigo 01, TipoOperacionCodigo 2001: 6 - TipoDocumentoCodigo 03, Todos los tipos de documento
ClienteNumeroDocIdentidadString10428985783El número del documento de identidad del cliente a quién se emite el comprobante
ListaDetallesArray[]La lista de detalles del comprobante, cada ítem del arreglo será del tipo DetalleComprobante que se detallará más adelante.
ExoneradaXMLDecimal0Total(sumatoria) del valor de venta neto de los productos exonerados
InafectoXMLDecimal0Total(sumatoria) del valor de venta neto de los productos inafectos
ExportacionXMLDecimal0Total(sumatoria) del valor de venta neto de los productos de exportación
ImporteTotalTextoStringQUINCE CON 00/100 SOLESImporte total del comprobante en texto
DescuentoGlobalMontoBaseDecimal0Valor Neto de la venta de los productos gravados
DescuentoGlobalNGMontoDecimal0Descuento Global en monto pero el valor neto de los productos no gravados
DescuentoGlobalNGMontoBaseDecimal0Valor Neto de la venta de los productos no gravados
DescuentoNGMontoDecimal0Descuento en monto de producto no gravado
CargoGlobalMontoDecimal0Recargo Global en monto pero el valor neto
CargoGlobalMontoBaseDecimal12.711864Valor Neto de la venta de los productos
ISCBaseDecimal0Sumatoria del ValorVentaItemXML
GratuitoGravadoDecimal0Total(sumatoria) del valor de venta neto de los productos
TotalPrecioVentaDecimal15Total precio de venta (subtotal de la factura)
TotalValorVentaDecimal12.711864Total valor de venta
ListaMovimientosArray[]Arreglo de objetos de movimientos de cuentas, este objeto se detallará más adelante.
CreditoTotalInt0Total de crédito del comprobante
TipoDocumentoCodigoString07Tipo de comprobante para la emisión lo valores posibles pueden ser: -01: FACTURA -03: BOLETA -07: NOTA DE CRÉDITO -08: NOTA DE DÉBITO -09: GUÍA REMITENTE -31: GUÍA TRANSPORTISTA -98: COTIZACIÓN -99: ORDEN
SerieStringFC01Serie del documento o comprobante
CorrelativoInt1129Número correlativo del documento o comprobante
MonedaCodigoStringPENCódigo de la moneda con la que se emitió el comprobante: PEN y USD
FechaEmisionString23/02/2023Cadena con la fecha de emisión del comprobante, esta fecha debe estar en el formato dd/mm/yyyy, esta fecha debe ser la misma fecha en la que se emite el comprobante.
TipoDocumentoCodigoModificadoString01Valor que representa el tipo de documento que se modifica, aplica en caso de que el comprobante sea de tipo 07 o 08, ya que estos documentos son de modificación de comprobantes, los valores posibles que puede contener son: - 01: FACTURA - 03: BOLETA DE VENTA
TipoOperacionCodigoString0101Este código sirve para identificar el tipo de operación a realizar y aplica al comprobante tipo 01 Factura, sus posibles valores pueden ser: - 0101: Venta interna - 0200: Exportación de Bienes - 0201: Exportación de Servicios – Prestación servicios realizados íntegramente en el país - 0202: Exportación de Servicios – Hospedaje No Domiciliado - 0205: Exportación de Servicios – Paquete Turístico - 1001: Operación Sujeta a Detracción - 2001: Operación Sujeta a Percepción Para el comprobante tipo 03 Boleta su valor debe ser 0101.
TipoCambioDecimal3.919El tipo de cambio del dólar
ClienteNombreRazonSocialStringCACERES PILLACARazón social del cliente a quién se emite el comprobante.
DescuentoGlobalPorcentajeInt0El porcentaje de descuento de los productos gravados
DescuentoGlobalValorInt0Descuento global como monto de los productos gravados
ObservacionStringANULACIÓN DE LA OPERACIÓNCampo que sirve para agregar una observación adicional al comprobante
GravadoDecimal12.711864Total(sumatoria) del valor de venta de los productos gravados
ExoneradaInt0Total(sumatoria) del valor de venta de los productos exonerados
InafectoInt0Total(sumatoria) del valor de venta de los productos inafectos
GratuitoInt0Total(sumatoria) del valor de venta de los productos gratuitos no gravados
TotalDescuentosInt0Total de los descuentos tanto global como descuento por ítem
DescuentoGlobalDecimal0Total de los descuentos tanto global como descuento por ítem
TotalAnticiposInt0Total de todos los anticipos
ISCInt0Monto calculado después de ingresar el ISCPorcentaje
IGVDecimal2.288135Suma IGV de todos los ítems
ICBPERInt0Total del Impuesto al consumo de las bolsas de plástico
TotalOtrosCargosInt0Total de los otros cargos
TotalImporteVentaInt15Importe total de la venta, cesión en uso o del servicio prestado
PercepcionTotalInt0Monto total de la percepción
TotalPagoInt15Total a pagar
MontoRetencionInt0Monto de la retención
PendientePagoString15.00Total pendiente de pago

Orden

Objeto para la emisión de una Orden

Para la emisión de una Orden se utiliza el objeto comprobante, este objeto a diferencia de los demás; tiene por datos específicos para la emisión de este comprobante.




Respuesta de la petición

El tipo de respuesta es un json y tendremos una respuesta con datos del XML y/o CDR como la siguiente:




Descripción de los elementos del objeto
campotipoValor Ejemplodescripción
UsuarioString20190306Código del usuario que emitió el comprobante
SucursalString3677El id que identifica a la sucursal para la cual se está emitiendo el comprobante
IGVPorcentajeDecimal18Porcentaje que se aplicará a la venta (los restaurantes pueden solicitar que sea 10)
DescuentoGlobalMontoDecimal0Descuento Global en monto pero el valor neto de los productos gravados
CargoGlobalIndicadorCargosString0.000000Indicador para el XML que se enviara a la SUNAT
CargoGlobalPorcentajeDecimal0El porcentaje de descuento de los productos
CargoGlobalCodigoMotivoString0Recargo al consumo y/o propinas
OrigenSistemaInt0Origen del sistema
CanalVentaString2Canal de venta
VendedorString20190306Identificador del vendedor
CondicionPagoStringContadoCondición en la cual se realiza el pago del comprobante, sus valores pueden ser: Contado, Credito.
UbigeoString150115Código de ubigeo del cliente a quién se emite el comprobante.
ClienteTipoDocIdentidadCodigoString6Cadena que representa el tipo de documento de identidad del cliente del comprobante, los valores que este campo puede aceptar son los siguientes: - -: SN DOC.DOM - 0: DOC. TRIB. - 1: L.E/DNI - 4: CARNET EXT - 6: RUC - 7: PASAPORTE - 9: CARNÉ SOLIC. REFUGIO - A: CED. DIPL. - B: DOC. PAIS RESID. - C: DOC TIN - PP.NN - D: DOC IN - PP.JJ - E: TARJETA ANDINA - TAM - F: PERMISO TEMPORAL - PTP - G: SALVOCONDUCTO - I: CARNÉ C.IDENT.-RREE - J: DOC.ID.EXTR. Sin embargo, estos tipos serán válidos para ciertos comprobantes y para ciertos casos, estos son: - TipoDocumentoCodigo 01, operación 0101: 6 - TipoDocumentoCodigo 01, TipoOperacionCodigo 0101: 6 - TipoDocumentoCodigo 01, TipoOperacionCodigo 0200: 0, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0201: 0, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0202: 0, 6, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0205: 7, B - TipoDocumentoCodigo 01, TipoOperacionCodigo 2001: 6 - TipoDocumentoCodigo 03, Todos los tipos de documento
ClienteNumeroDocIdentidadString10428985783El número del documento de identidad del cliente a quién se emite el comprobante
ListaDetallesArray[]La lista de detalles del comprobante, cada ítem del arreglo será del tipo DetalleComprobante que se detallará más adelante.
ExoneradaXMLDecimal0Total(sumatoria) del valor de venta neto de los productos exonerados
InafectoXMLDecimal0Total(sumatoria) del valor de venta neto de los productos inafectos
ExportacionXMLDecimal0Total(sumatoria) del valor de venta neto de los productos de exportación
ImporteTotalTextoStringQUINCE CON 00/100 SOLESImporte total del comprobante en texto
DescuentoGlobalMontoBaseDecimal0Valor Neto de la venta de los productos gravados
DescuentoGlobalNGMontoDecimal0Descuento Global en monto pero el valor neto de los productos no gravados
DescuentoGlobalNGMontoBaseDecimal0Valor Neto de la venta de los productos no gravados
DescuentoNGMontoDecimal0Descuento en monto de producto no gravado
CargoGlobalMontoDecimal0Recargo Global en monto pero el valor neto
CargoGlobalMontoBaseDecimal12.711864Valor Neto de la venta de los productos
ISCBaseDecimal0Sumatoria del ValorVentaItemXML
GratuitoGravadoDecimal0Total(sumatoria) del valor de venta neto de los productos
TotalPrecioVentaDecimal15Total precio de venta (subtotal de la factura)
TotalValorVentaDecimal12.711864Total valor de venta
ListaMovimientosArray[]Arreglo de objetos de movimientos de cuentas, este objeto se detallará más adelante.
CreditoTotalInt0Total de crédito del comprobante
TipoDocumentoCodigoString07Tipo de comprobante para la emisión lo valores posibles pueden ser: -01: FACTURA -03: BOLETA -07: NOTA DE CRÉDITO -08: NOTA DE DÉBITO -09: GUÍA REMITENTE -31: GUÍA TRANSPORTISTA -98: COTIZACIÓN -99: ORDEN
SerieStringFC01Serie del documento o comprobante
CorrelativoInt1129Número correlativo del documento o comprobante
MonedaCodigoStringPENCódigo de la moneda con la que se emitió el comprobante: PEN y USD
FechaEmisionString23/02/2023Cadena con la fecha de emisión del comprobante, esta fecha debe estar en el formato dd/mm/yyyy, esta fecha debe ser la misma fecha en la que se emite el comprobante.
TipoDocumentoCodigoModificadoString01Valor que representa el tipo de documento que se modifica, aplica en caso de que el comprobante sea de tipo 07 o 08, ya que estos documentos son de modificación de comprobantes, los valores posibles que puede contener son: - 01: FACTURA - 03: BOLETA DE VENTA
TipoOperacionCodigoString0101Este código sirve para identificar el tipo de operación a realizar y aplica al comprobante tipo 01 Factura, sus posibles valores pueden ser: - 0101: Venta interna - 0200: Exportación de Bienes - 0201: Exportación de Servicios – Prestación servicios realizados íntegramente en el país - 0202: Exportación de Servicios – Hospedaje No Domiciliado - 0205: Exportación de Servicios – Paquete Turístico - 1001: Operación Sujeta a Detracción - 2001: Operación Sujeta a Percepción Para el comprobante tipo 03 Boleta su valor debe ser 0101.
TipoCambioDecimal3.919El tipo de cambio del dólar
ClienteNombreRazonSocialStringCACERES PILLACARazón social del cliente a quién se emite el comprobante.
DescuentoGlobalPorcentajeInt0El porcentaje de descuento de los productos gravados
DescuentoGlobalValorInt0Descuento global como monto de los productos gravados
ObservacionStringANULACIÓN DE LA OPERACIÓNCampo que sirve para agregar una observación adicional al comprobante
GravadoDecimal12.711864Total(sumatoria) del valor de venta de los productos gravados
ExoneradaInt0Total(sumatoria) del valor de venta de los productos exonerados
InafectoInt0Total(sumatoria) del valor de venta de los productos inafectos
GratuitoInt0Total(sumatoria) del valor de venta de los productos gratuitos no gravados
TotalDescuentosInt0Total de los descuentos tanto global como descuento por ítem
DescuentoGlobalDecimal0Total de los descuentos tanto global como descuento por ítem
TotalAnticiposInt0Total de todos los anticipos
ISCInt0Monto calculado después de ingresar el ISCPorcentaje
IGVDecimal2.288135Suma IGV de todos los ítems
ICBPERInt0Total del Impuesto al consumo de las bolsas de plástico
TotalOtrosCargosInt0Total de los otros cargos
TotalImporteVentaInt15Importe total de la venta, cesión en uso o del servicio prestado
PercepcionTotalInt0Monto total de la percepción
TotalPagoInt15Total a pagar
MontoRetencionInt0Monto de la retención
PendientePagoString15.00Total pendiente de pago

Nota de Crédito

Objeto para la emisión de una Nota de Crédito

Para la emisión de una nota de crédito se utiliza el objeto comprobante, este objeto a diferencia de los demás; tiene por datos específicos para la emisión de este comprobante.




Respuesta de la petición

El tipo de respuesta es un json y tendremos una respuesta con datos del XML y/o CDR como la siguiente:




Descripción de los elementos del objeto
campotipoValor Ejemplodescripción
IDlong0Este valor es el identificador del comprobante y se genera automáticamente por NUESTRO SISTEMA en el momento de la emisión del comprobante.
UsuarioString20190306Código del usuario que emitió el comprobante
SucursalString3677El id que identifica a la sucursal para la cual se está emitiendo el comprobante
IGVPorcentajeDecimal18Porcentaje que se aplicará a la venta (los restaurantes pueden solicitar que sea 10)
DescuentoGlobalMontoDecimal0Descuento Global en monto pero el valor neto de los productos gravados
CargoGlobalPorcentajeDecimal0El porcentaje de descuento de los productos
CargoGlobalIndicadorCargosString0.000000Indicador para el XML que se enviara a la SUNAT
CargoGlobalCodigoMotivoString0Recargo al consumo y/o propinas
OrigenSistemaInt0Origen del sistema
CanalVentaString2Canal de venta
VendedorString20190306Identificador del vendedor
CondicionPagoStringContadoCondición en la cual se realiza el pago del comprobante, sus valores pueden ser: Contado, Credito.
UbigeoString150115Código de ubigeo del cliente a quién se emite el comprobante.
SeCambiaFechaBoolfalseValor si se cambiara la fecha, sus valores pueden ser: True, false
ClienteTipoDocIdentidadCodigoString6Cadena que representa el tipo de documento de identidad del cliente del comprobante, los valores que este campo puede aceptar son los siguientes: - -: SN DOC.DOM - 0: DOC. TRIB. - 1: L.E/DNI - 4: CARNET EXT - 6: RUC - 7: PASAPORTE - 9: CARNÉ SOLIC. REFUGIO - A: CED. DIPL. - B: DOC. PAIS RESID. - C: DOC TIN - PP.NN - D: DOC IN - PP.JJ - E: TARJETA ANDINA - TAM - F: PERMISO TEMPORAL - PTP - G: SALVOCONDUCTO - I: CARNÉ C.IDENT.-RREE - J: DOC.ID.EXTR. Sin embargo, estos tipos serán válidos para ciertos comprobantes y para ciertos casos, estos son: - TipoDocumentoCodigo 01, operación 0101: 6 - TipoDocumentoCodigo 01, TipoOperacionCodigo 0101: 6 - TipoDocumentoCodigo 01, TipoOperacionCodigo 0200: 0, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0201: 0, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0202: 0, 6, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0205: 7, B - TipoDocumentoCodigo 01, TipoOperacionCodigo 2001: 6 - TipoDocumentoCodigo 03, Todos los tipos de documento
ClienteNumeroDocIdentidadString10428985783El número del documento de identidad del cliente a quién se emite el comprobante
ListaMovimientosArray[]Arreglo de objetos de movimientos de cuentas, este objeto se detallará más adelante.
ListaDetallesArray[]La lista de detalles del comprobante, cada ítem del arreglo será del tipo DetalleComprobante que se detallará más adelante.
ExoneradaXMLDecimal0Total(sumatoria) del valor de venta neto de los productos exonerados
InafectoXMLDecimal0Total(sumatoria) del valor de venta neto de los productos inafectos
ExportacionXMLDecimal0Total(sumatoria) del valor de venta neto de los productos de exportación
ImporteTotalTextoStringQUINCE CON 00/100 SOLESImporte total del comprobante en texto
DetraccionDecimal0Descuento de un porcentaje del importe a pagar
DescuentoGlobalMontoBaseDecimal0Valor Neto de la venta de los productos gravados
DescuentoGlobalNGMontoDecimal0Descuento Global en monto pero el valor neto de los productos no gravados
DescuentoGlobalNGMontoBaseDecimal0Valor Neto de la venta de los productos no gravados
DescuentoNGMontoDecimal0Descuento en monto de producto no gravado
AnticiposGravadoDecimal0Valor neto del Anticipo Gravado
AnticiposExoneradoDecimal0Valor neto del Anticipo Exonerado
AnticiposInafectoDecimal0Valor neto del Anticipo Inafecto
CargoGlobalMontoDecimal0Recargo Global en monto pero el valor neto
CargoGlobalMontoBaseDecimal12.711864Valor Neto de la venta de los productos
ISCBaseDecimal0Sumatoria del ValorVentaItemXML
GratuitoGravadoDecimal0Total(sumatoria) del valor de venta neto de los productos
TotalPrecioVentaDecimal15Total precio de venta (subtotal de la factura)
TotalValorVentaDecimal12.711864Total valor de venta
CreditoTotalInt0Total de crédito del comprobante
DesdeOrdenBoolfalseValor si se esta realizando desde orden, los valores pueden ser: true, false
TipoPrecioString0Tipo de precio
TipoDocumentoCodigoString07Tipo de comprobante para la emisión lo valores posibles pueden ser: -01: FACTURA -03: BOLETA -07: NOTA DE CRÉDITO -08: NOTA DE DÉBITO -09: GUÍA REMITENTE -31: GUÍA TRANSPORTISTA -98: COTIZACIÓN -99: ORDEN
SerieStringFC01Serie del documento o comprobante
CorrelativoInt1129Número correlativo del documento o comprobante
MonedaCodigoStringPENCódigo de la moneda con la que se emitió el comprobante: PEN y USD
FechaEmisionString23/02/2023Cadena con la fecha de emisión del comprobante, esta fecha debe estar en el formato dd/mm/yyyy, esta fecha debe ser la misma fecha en la que se emite el comprobante.
TipoDocumentoCodigoModificadoString01Valor que representa el tipo de documento que se modifica, aplica en caso de que el comprobante sea de tipo 07 o 08, ya que estos documentos son de modificación de comprobantes, los valores posibles que puede contener son: - 01: FACTURA - 03: BOLETA DE VENTA
SerieModificadoStringF001Serie del documento que se modifica cuando el comprobante que se emite es del tipo 07 o 08.
CorrelativoModificadoString11392Correlativo que se modifica cuando el comprobante que se emite es de tipo 07 o 08
TipoNotaCreditoCodigoString01Valor que identifica el tipo de nota de crédito, aplica si el comprobante es de tipo 07. - 01: Anulación de la operación - 03: Corrección por error en la descripción - 04: Descuento global - 06: Devolución total - 07: Devolución por ítem - 13: Ajustes – montos y/o fechas de pago
TipoNotaDebitoCodigoString01Valor que identifica el tipo de nota de débito, este valor solo aplica cuando el comprobante es de tipo 08. - 01: INTERESES POR MORA - 02: AUMENTO EN EL VALOR - 03: PENALIDAD
TipoOperacionCodigoString0101Este código sirve para identificar el tipo de operación a realizar y aplica al comprobante tipo 01 Factura, sus posibles valores pueden ser: - 0101: Venta interna - 0200: Exportación de Bienes - 0201: Exportación de Servicios – Prestación servicios realizados íntegramente en el país - 0202: Exportación de Servicios – Hospedaje No Domiciliado - 0205: Exportación de Servicios – Paquete Turístico - 1001: Operación Sujeta a Detracción - 2001: Operación Sujeta a Percepción Para el comprobante tipo 03 Boleta su valor debe ser 0101.
TipoCambioDecimal3.919El tipo de cambio del dólar
MotivoTrasladoCodigoString01Codigo del motivo de traslado
ClienteNombreRazonSocialStringCACERES PILLACARazón social del cliente a quién se emite el comprobante.
ClienteDireccionStringJR. ARENALESDirección del cliente a quién se emite el comprobante.
DescuentoGlobalPorcentajeInt0El porcentaje de descuento de los productos gravados
DescuentoGlobalValorInt0Descuento global como monto de los productos gravados
ObservacionStringANULACIÓN DE LA OPERACIÓNCampo que sirve para agregar una observación adicional al comprobante
GravadoDecimal12.711864Total(sumatoria) del valor de venta de los productos gravados
ExoneradaInt0Total(sumatoria) del valor de venta de los productos exonerados
InafectoInt0Total(sumatoria) del valor de venta de los productos inafectos
ExportacionInt0Total(sumatoria) del valor de venta de los productos exportación
GratuitoInt0Total(sumatoria) del valor de venta de los productos gratuitos no gravados
TotalDescuentosInt0Total de los descuentos tanto global como descuento por ítem
TotalAnticiposInt0Total de todos los anticipos
ISCInt0Monto calculado después de ingresar el ISCPorcentaje
IGVDecimal2.288135Suma IGV de todos los ítems
ICBPERInt0Total del Impuesto al consumo de las bolsas de plástico
ImpuestoTotalDecimal2.288135Total de los impuestos a pagar (IGV, ISC, ICBPER, etc)
TotalOtrosCargosInt0Total de los otros cargos
TotalImporteVentaInt15Importe total de la venta, cesión en uso o del servicio prestado
PercepcionTotalInt0Monto total de la percepción
TotalPagoInt15Total a pagar
LeyendaInt0Cuando es Factura, los valores son: - 0: Ninguno - 3: BIENES TRANSFERIDOS EN LA AMAZONIA REGION SELVA PARA SER CONSUMIDOS EN LA MISMA - 4: SERVICIOS TRANSFERIDOS EN LA AMAZONIA REGION SELVA PARA SER CONSUMIDOS EN LA MISMA - 5: CONTRATOS DE CONSTRUCCION EJECUTADOS EN LA AMAZONIA REGION SELVA Cuando es Boleta, los valores son: - 0: Ninguno - 1: BIENES TRASNFERIDOS EN LA AMAZONIA REGION SELVA PARA SER CONSUMIDOS EN LA MISMA - 2: SERVICIOS TRANSFERIDOS EN LA AMAZONIA REGION SELVA PARA SER CONSUMIDOS EN LA MISMA - 3: CONTRATOS DE CONSTRUCCION EJECUTADOS EN LA AMAZONIA REGION SELVA
DocAdicionalCodigoInt0Codigo de documento adicional, sus valores pueden ser: - 0: Ninguno - 1: Orden Compra - 2: Pedido
DocAdicionalDetalleStringDetalle de documento adicional
MontoRetencionInt0Monto de la retención
PendientePagoString15.00Total pendiente de pago
FechaIngresoPaisString23/02/2023Fecha de ingreso al país, el formato deberá estar en dd/mm/yyyy
FechaIngresoEstablecimientoString23/02/2023Fecha de ingreso de establecimiento, el formato deberá estar en dd/mm/yyyy

Nota de Débito

Objeto para la emisión de una Nota de Débito

Para la emisión de una nota de débito se utiliza el objeto comprobante, este objeto a diferencia de los demás; tiene por datos específicos para la emisión de este comprobante.




Respuesta de la petición

El tipo de respuesta es un json y tendremos una respuesta con datos del XML y/o CDR como la siguiente:




Descripción de los elementos del objeto
campotipoValor Ejemplodescripción
UsuarioString20190306Código del usuario que emitió el comprobante
SucursalString3677El id que identifica a la sucursal para la cual se está emitiendo el comprobante
IGVPorcentajeDecimal18Porcentaje que se aplicará a la venta (los restaurantes pueden solicitar que sea 10)
CargoGlobalPorcentajeDecimal0El porcentaje de descuento de los productos
CargoGlobalIndicadorCargosString0.000000Indicador para el XML que se enviara a la SUNAT
CargoGlobalCodigoMotivoString0Recargo al consumo y/o propinas
OrigenSistemaInt0Origen del sistema
VendedorString20190306Identificador del vendedor
CondicionPagoStringContadoCondición en la cual se realiza el pago del comprobante, sus valores pueden ser: Contado, Credito.
UbigeoString150115Código de ubigeo del cliente a quién se emite el comprobante.
ClienteTipoDocIdentidadCodigoString6Cadena que representa el tipo de documento de identidad del cliente del comprobante, los valores que este campo puede aceptar son los siguientes: - -: SN DOC.DOM - 0: DOC. TRIB. - 1: L.E/DNI - 4: CARNET EXT - 6: RUC - 7: PASAPORTE - 9: CARNÉ SOLIC. REFUGIO - A: CED. DIPL. - B: DOC. PAIS RESID. - C: DOC TIN - PP.NN - D: DOC IN - PP.JJ - E: TARJETA ANDINA - TAM - F: PERMISO TEMPORAL - PTP - G: SALVOCONDUCTO - I: CARNÉ C.IDENT.-RREE - J: DOC.ID.EXTR. Sin embargo, estos tipos serán válidos para ciertos comprobantes y para ciertos casos, estos son: - TipoDocumentoCodigo 01, operación 0101: 6 - TipoDocumentoCodigo 01, TipoOperacionCodigo 0101: 6 - TipoDocumentoCodigo 01, TipoOperacionCodigo 0200: 0, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0201: 0, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0202: 0, 6, 7, A, B, C, D,E, F, G - TipoDocumentoCodigo 01, TipoOperacionCodigo 0205: 7, B - TipoDocumentoCodigo 01, TipoOperacionCodigo 2001: 6 - TipoDocumentoCodigo 03, Todos los tipos de documento
ClienteNumeroDocIdentidadString10428985783El número del documento de identidad del cliente a quién se emite el comprobante
ListaDetallesArray[]La lista de detalles del comprobante, cada ítem del arreglo será del tipo DetalleComprobante que se detallará más adelante.
ExoneradaXMLDecimal0Total(sumatoria) del valor de venta neto de los productos exonerados
InafectoXMLDecimal0Total(sumatoria) del valor de venta neto de los productos inafectos
ExportacionXMLDecimal0Total(sumatoria) del valor de venta neto de los productos de exportación
ImporteTotalTextoStringQUINCE CON 00/100 SOLESImporte total del comprobante en texto
DescuentoGlobalMontoBaseDecimal0Valor Neto de la venta de los productos gravados
DescuentoGlobalNGMontoDecimal0Descuento Global en monto pero el valor neto de los productos no gravados
DescuentoGlobalNGMontoBaseDecimal0Valor Neto de la venta de los productos no gravados
DescuentoNGMontoDecimal0Descuento en monto de producto no gravado
CargoGlobalMontoDecimal0Recargo Global en monto pero el valor neto
CargoGlobalMontoBaseDecimal12.711864Valor Neto de la venta de los productos
ISCBaseDecimal0Sumatoria del ValorVentaItemXML
GratuitoGravadoDecimal0Total(sumatoria) del valor de venta neto de los productos
TotalPrecioVentaDecimal15Total precio de venta (subtotal de la factura)
TotalValorVentaDecimal12.711864Total valor de venta
ListaMovimientosArray[]Arreglo de objetos de movimientos de cuentas, este objeto se detallará más adelante.
CreditoTotalInt0Total de crédito del comprobante
TipoDocumentoCodigoString07Tipo de comprobante para la emisión lo valores posibles pueden ser: -01: FACTURA -03: BOLETA -07: NOTA DE CRÉDITO -08: NOTA DE DÉBITO -09: GUÍA REMITENTE -31: GUÍA TRANSPORTISTA -98: COTIZACIÓN -99: ORDEN
SerieStringFC01Serie del documento o comprobante
CorrelativoInt1129Número correlativo del documento o comprobante
MonedaCodigoStringPENCódigo de la moneda con la que se emitió el comprobante: PEN y USD
FechaEmisionString23/02/2023Cadena con la fecha de emisión del comprobante, esta fecha debe estar en el formato dd/mm/yyyy, esta fecha debe ser la misma fecha en la que se emite el comprobante.
TipoDocumentoCodigoModificadoString01Valor que representa el tipo de documento que se modifica, aplica en caso de que el comprobante sea de tipo 07 o 08, ya que estos documentos son de modificación de comprobantes, los valores posibles que puede contener son: - 01: FACTURA - 03: BOLETA DE VENTA
SerieModificadoStringF001Serie del documento que se modifica cuando el comprobante que se emite es del tipo 07 o 08.
CorrelativoModificadoString11392Correlativo que se modifica cuando el comprobante que se emite es de tipo 07 o 08
TipoNotaCreditoCodigoString01Valor que identifica el tipo de nota de crédito, aplica si el comprobante es de tipo 07. - 01: Anulación de la operación - 03: Corrección por error en la descripción - 04: Descuento global - 06: Devolución total - 07: Devolución por ítem - 13: Ajustes – montos y/o fechas de pago
TipoNotaDebitoCodigoString01Valor que identifica el tipo de nota de débito, este valor solo aplica cuando el comprobante es de tipo 08. - 01: INTERESES POR MORA - 02: AUMENTO EN EL VALOR - 03: PENALIDAD
TipoOperacionCodigoString0101Este código sirve para identificar el tipo de operación a realizar y aplica al comprobante tipo 01 Factura, sus posibles valores pueden ser: - 0101: Venta interna - 0200: Exportación de Bienes - 0201: Exportación de Servicios – Prestación servicios realizados íntegramente en el país - 0202: Exportación de Servicios – Hospedaje No Domiciliado - 0205: Exportación de Servicios – Paquete Turístico - 1001: Operación Sujeta a Detracción - 2001: Operación Sujeta a Percepción Para el comprobante tipo 03 Boleta su valor debe ser 0101.
TipoCambioDecimal3.919El tipo de cambio del dólar
ClienteNombreRazonSocialStringCACERES PILLACARazón social del cliente a quién se emite el comprobante.
ClienteDireccionStringJR. ARENALESDirección del cliente a quién se emite el comprobante.
DescuentoGlobalPorcentajeInt0El porcentaje de descuento de los productos gravados
DescuentoGlobalValorInt0Descuento global como monto de los productos gravados
ObservacionStringANULACIÓN DE LA OPERACIÓNCampo que sirve para agregar una observación adicional al comprobante
GravadoDecimal12.711864Total(sumatoria) del valor de venta de los productos gravados
ExoneradaInt0Total(sumatoria) del valor de venta de los productos exonerados
InafectoInt0Total(sumatoria) del valor de venta de los productos inafectos
GratuitoInt0Total(sumatoria) del valor de venta de los productos gratuitos no gravados
TotalDescuentosInt0Total de los descuentos tanto global como descuento por ítem
DescuentoGlobalDecimal0Descuento global
TotalAnticiposDecimal0Total de todos los anticipos
IGVDecimal2.288135Suma IGV de todos los ítems
ICBPERInt0Total del Impuesto al consumo de las bolsas de plástico
ImpuestoTotalDecimal2.288135Total de los impuestos a pagar (IGV, ISC, ICBPER, etc)
TotalOtrosCargosInt0Total de los otros cargos
TotalImporteVentaInt15Importe total de la venta, cesión en uso o del servicio prestado
PercepcionTotalInt0Monto total de la percepción
TotalPagoDecimal15Total a pagar
MontoRetencionDecimal0Monto de la retención
PendientePagoDecimal15.00Total pendiente de pago

Ejemplos de emisión

Tipos de afectación:
CodigoTipo de afectación
10Gravado - Operación Onerosa
11Gravado - Retiro por premio
13Gravado - Retiro
15Gravado - Bonificaciones
16Gravado - Retiro por entrega a trabajadores
20Exonerado - Operación Onerosa
21Exonerado - Transferencia gratuita
30Inafecto - Operación Onerosa
31Inafecto - Retiro por Bonificación
35Inafecto - Retiro por premio
36Inafecto - Retiro por publicidad
40Exportación



Ejemplos:
Tipo de afectación CodigoDescripciónStockCantidadUNI. MED.Precio unitarioDescuento (%)GananciaIGVImporte
"10"Producto gravado11UNIDAD118011818118
"20"Producto exonerado11UNIDAD11801180118
"30"Producto inafecto11UNIDAD11801180118



Objetos Json:
Objeto de json gravado
Objeto de json exonerado
Objeto de json inafecto



Ejemplos de archivos Json:

Tenemos archivos JSON de ejemplo para la mayoría de casos:

FACTURAS
  1. EMISIÓN POR VENTA INTERNA CON OPERACIÓN GRAVADA
  2. EMISIÓN POR VENTA INTERNA CON OPERACIÓN EXONERADA
  3. EMISIÓN POR VENTA INTERNA CON OPERACIÓN GRATUITA
  4. EMISIÓN POR VENTA INTERNA CON OPERACIÓN INAFECTO
  5. EMISIÓN POR VENTA INTERNA CON OPERACIÓN EXONERADA Y OPERACIÓN INAFECTA
  6. EMISIÓN POR VENTA INTERNA CON DESCUENTO POR ITEM GRAVADO
  7. EMISIÓN POR VENTA INTERNA CON DESCUENTO GLOBAL GRAVADO
  8. EMISIÓN POR VENTA INTERNA CON DESCUENTO GLOBAL GRAVADO Y EXONERADO
  9. EMISIÓN POR VENTA INTERNA CON DESCUENTO POR ITEM Y DESCUENTO GLOBAL
  10. EMISIÓN POR VENTA INTERNA CON ISC
  11. EMISIÓN POR VENTA INTERNA CON OTROS CARGOS
  12. EMISIÓN POR VENTA INTERNA CON PERCEPCIÓN
  13. EMISIÓN POR VENTA INTERNA CON DETRACCIÓN
  14. EMISIÓN POR VENTA INTERNA ADJUNTANDO GUIA DE REMISIÓN
  15. EMISIÓN POR VENTA INTERNA CON OPERACIÓN GRAVADA Y OTROS CARGOS
  16. MUCHO MÁS
Descargar archivos JSON de ejemplo
BOLETAS
  1. EMISIÓN POR VENTA INTERNA CON OPERACIÓN GRAVADA
  2. EMISIÓN POR VENTA INTERNA CON OPERACIÓN GRAVADA Y OPERACIÓN INAFECTA
  3. EMISIÓN POR VENTA INTERNA CON DESCUENTO POR ITEM EXONERADO
  4. EMISIÓN POR VENTA INTERNA CON DESCUENTO GLOBAL GRAVADO
  5. EMISIÓN POR VENTA INTERNA CON ISC Y OPERACIÓN GRAVADA
  6. EMISIÓN POR VENTA INTERNA CON ISC Y OPERACIÓN EXONERADA CON OPERACIÓN INAFECTA
  7. EMISIÓN POR VENTA INTERNA CON OTROS CARGOS CON OPERACIÓN GRAVADA
  8. EMISIÓN POR VENTA INTERNA CON OTROS CARGOS MAS OPERACIÓN GRAVADA Y OPERACIÓN EXONERADA
  9. EMISIÓN POR VENTA INTERNA CON DOLARES
  10. EMISIÓN POR VENTA INTERNA ADJUNTANDO GUIA DE REMISIÓN
  11. EMISIÓN POR VENTA INTERNA CON OPERACIÓN GRATUITA
  12. EMISIÓN POR VENTA INTERNA CON PRIMER ANTICIPO
  13. EMISIÓN POR VENTA INTERNA CON REGULARIZACION DE ANTICIPO
  14. EMISIÓN POR VENTA INTERNA CON PAGO MULTIPLE
  15. MUCHO MÁS
Descargar archivos JSON de ejemplo
NOTA DE CRÉDITO
  1. EMISIÓN DE NOTA DE CRÉDITO DE FACTURA CON ANULACIÓN DE LA OPERACIÓN
  2. EMISIÓN DE NOTA DE CRÉDITO DE FACTURA CON CORRECIÓN POR ERROR EN LA DESCRIPCIÓN
  3. EMISIÓN DE NOTA DE CRÉDITO DE FACTURA CON DESCUENTO GLOBAL
  4. EMISIÓN DE NOTA DE CRÉDITO DE FACTURA CON DEVOLUCIÓN TOTAL
  5. EMISIÓN DE NOTA DE CRÉDITO DE FACTURA CON DEVOLUCIÓN POR ITEM
  6. EMISIÓN DE NOTA DE CRÉDITO DE FACTURA CON AJUSTES - MONTOS Y/O FECHAS DE PAGO
  7. EMISIÓN DE NOTA DE CRÉDITO DE BOLETA CON ANULACIÓN DE LA OPERACIÓN
  8. EMISIÓN DE NOTA DE CRÉDITO DE BOLETA CON CORRECIÓN POR ERROR EN LA DESCRIPCIÓN
  9. EMISIÓN DE NOTA DE CRÉDITO DE BOLETA CON DESCUENTO GLOBAL
  10. EMISIÓN DE NOTA DE CRÉDITO DE BOLETA CON DEVOLUCIÓN TOTAL
  11. EMISIÓN DE NOTA DE CRÉDITO DE BOLETA CON DEVOLUCIÓN POR ITEM
  12. EMISIÓN DE NOTA DE CRÉDITO DE BOLETA CON AJUSTES - MONTOS Y/O FECHAS DE PAGO
  13. EMISIÓN DE NOTA DE CRÉDITO POR FACTURA AL CRÉDITO
  14. EMISIÓN DE NOTA DE CRÉDITO POR BOLETA AL CRÉDITO
Descargar archivos JSON de ejemplo
GUIA REMITENTE
  1. EMISIÓN DE GUIA REMITENTE CON MOTIVO VENTA CON TRANSPORTE PUBLICO
  2. EMISIÓN DE GUIA REMITENTE CON MOTIVO COMPRA CON TRANSPORTE PUBLICO
  3. EMISIÓN DE GUIA REMITENTE CON MOTIVO TRASLADO ENTRE ESTABLECIMIENTOS DE LA MISMA EMPRESA CON TRANSPORTE PUBLICO
  4. EMISIÓN DE GUIA REMITENTE CON MOTIVO OTROS CON TRANSPORTE PUBLICO
  5. EMISIÓN DE GUIA REMITENTE CON MOTIVO VENTA SUJETA A CONFIRMACIÓN DEL COMPRADOR CON TRANSPORTE PUBLICO
  6. EMISIÓN DE GUIA REMITENTE CON MOTIVO TRASLADO EMISOR ITINERANTE CP CON TRANSPORTE PUBLICO
  7. EMISIÓN DE GUIA REMITENTE CON MOTIVO VENTA CON TRANSPORTE PRIVADO
  8. EMISIÓN DE GUIA REMITENTE CON MOTIVO COMPRA CON TRANSPORTE PUBLICO
  9. EMISIÓN DE GUIA REMITENTE CON MOTIVO TRASLADO ENTRE ESTABLECIMIENTOS DE LA MISMA EMPRESA CON TRANSPORTE PRIVADO
  10. EMISIÓN DE GUIA REMITENTE CON MOTIVO OTROS CON TRANSPORTE PRIVADO
  11. EMISIÓN DE GUIA REMITENTE CON MOTIVO TRASLADO EMISOR ITINERANTE CP TRANSPORTE PRIVADO
  12. MUCHO MÁS
Descargar archivos JSON de ejemplo
NOTA DE DÉBITO
  1. EMISIÓN DE NOTA DE DÉBITO DE FACTURA CON INTERES POR MORA
  2. EMISIÓN DE NOTA DE DÉBITO DE FACTURA CON AUMENTO EN EL VALOR
  3. EMISIÓN DE NOTA DE DÉBITO DE FACTURA CON PENALIDAD
  4. EMISIÓN DE NOTA DE DÉBITO DE BOLETA CON INTERES POR MORA
  5. EMISIÓN DE NOTA DE DÉBITO DE BOLETA AUMENTO EN EL VALOR
  6. EMISIÓN DE NOTA DE DÉBITO DE BOLETA CON PENALIDAD
Descargar archivos JSON de ejemplo

Detalles

Objeto para la creación de un detalle



Descripción de los elementos del objeto
campotipoValor Ejemplodescripción
IDlong0Número que sirve para identificar el comprobante
ComprobanteIDlong0Número que sirve para identificar el comprobante
Itemint1Numeración de los detalles
ProductoCodigostringProd00151Código correlativo asignado por el sistema a un producto
ProductoCodigoClientestringUBI2023Código del producto asignado por el cliente a un producto
ProductoCodigoSUNATstring39121321Código de SUNAT
TipoSistemaISCCodigostring-01 Sistema al valor -02 Aplicación del monto fijo -03 Sistema de precios de Venta al PúblicoTipo de afectación ISC para un producto
UnidadMedidaCodigostringvalorAbreviatura de la Unidad de Medida
PrecioUnitarioItemdecimal236Monto asignado con IGV de cada producto
PrecioVentaCodigostring0 o 1Código de precio de venta
ICBPERdecimal0.5Impuesto que grava la compra de bolsas plásticas
DescuentoIndicadorstring0 o 1Opción para escoger el tipo de descuento – 0 (%) 1 (S/.)
PercepcionPorcentajedecimal0Tasa de percepción agregada a un producto
PrecioCompradecimal50Monto ingresado con el cual el producto fue comprado
CantidadUnidadMedidadecimal1Es el número que contiene la unidad
KitbooltrueProducto final compuesto con varios productos
PrecioUnitarioNetodecimal150Monto asignado con IMPUESTOS de cada producto con resta de los descuentos
Cargodecimal18.4375Monto que resulta del valor unitario por el recargo ingresado
Descuentodecimal40Monto que se ingresa al sistema
ValorUnitariodecimal200Monto asignado sin IGV de una unidad
ValorUnitarioNetodecimal127.118Monto asignado sin IMPUESTOS de cada producto con resta de los descuentos
ValorVentaItemdecimal127.118Monto asignado sin IGV de cada producto
ValorVentaItemXMLdecimal127.118Monto asignado sin IGV de cada producto menos el descuento
ISCdecimal39.996399Monto calculado después de ingresar el ISCPorcentaje
IGVdecimal18Impuesto que pagan los ciudadanos al realizar una adquisición
ICBPERSubTotaldecimal1Sumatoria del ICBPER según la cantidad de los productos
DescuentoBasedecimal400Monto asignado por el sistema
CargoItemdecimal36.875Monto que resulta del valor unitario por el recargo ingresado
PrecioVentadecimal472El monto final ingresado por el cliente
MontoTributodecimal66.375IGV
ISCPorcentajedecimal11.11Monto ingresado para calcular el ISC
CargoPorcentajedecimal10Monto que resulta del valor unitario por el recargo ingresado
DescripcionstringPRODUCTO GRAVADODetalle el nombre del producto
ObservacionstringRegularización del anticipoCampo que sirve para agregar una observación adicional al comprobante
Stockdecimal5Cantidad
Cantidaddecimal2Número que indica el contenido del producto
PrecioCodigodecimal535Código de precio
PrecioUnitariodecimal236Monto asignado con IGV de una unidad
Pesodecimal1Cantidad que indica la masa de un producto
DescuentoMontodecimal23.6Es el resultado obtenido del precio final entre el descuento
DescuentoPorcentajedecimal10Monto ingresado para el descuento
TipoAfectacionIGVCodigostring10 Gravado – Operación OnerosaSon los distintos tipos de afectación IGV
ValorVentadecimal400Monto que establece un vendedor para la adquisición de bienes o servicios que ofrece el comprador
ImporteTotaldecimal472Monto total
PesoTotaldecimal1Sumatoria total de las cantidades de todo los productos

Movimientos

Objeto para la creación de movimientos



Descripción de los elementos del objeto
campotipoValor Ejemplodescripción
TipoDocumentoCodigoString01Código del tipo del documento o comprobante: 01: Factura, 03: Boleta, 07: Nota de crédito, 08: Nota de débito, 99: Orden
SerieStringF001Serie del documento o comprobante
CorrelativoInt1Número correlativo del documento o comprobante
CondicionStringContadoCondición con la que fue emitido el comprobante: Contado o Credito
CondicionComprobanteStringContadoCondición del comprobante recuperado con nota de crédito o débito: Contado o Credito.
TipoCuentaCodigoInt1Código del tipo de cuenta, estos son: 1. Efectivo, 2. Tarjeta, 3. Banco
CuentaNumeroString10101010Número o código de la cuenta donde se registra el dinero.
UsuarioString10101010Código del usuario que emitió el comprobante
MonedaCodigoStringPENCódigo de la moneda con la que se emitió el comprobante: PEN y USD
SucursalIdInt1Código de la sucursal donde se emitió el comprobante.
TipoDocIdentidadCodigoString1Tipo del documento de identidad con la que se emitió el comprobante.
NumeroDocIdentidadString45454545Número del documento de identidad.
ObservacionStringVentasObservación o descripción del comprobante emitido.
CuentaNombreStringBCPNombre de la cuenta
CuentaValorString1-10101010Concatenación de TipoCuentaCodigo y CuentaNumero
PagoDecimal100.00Monto del importe total del comprobante.
VueltoDecimal10.00Monto del cálculo del vuelto
FechaPagoDateTime08/02/2023Fecha de la operación bancaria o tarjeta
NumeroOperacionString0455120Número de la operación bancaria o tarjeta
FechaVencimientoDateTime08/03/2023Fecha de vencimiento para comprobante emitido al crédito.
PlazoDiasInt30Número de días de plazo para comprobante emitido al crédito.

Anulación

Anulación de un comprobante

Estas líneas de código están enviando una solicitud de acceso a nuestro servidor web de RAPIFAC para poder Anular un Comprobante Electrónico, utilizando un token de autenticación proporcionado en el Inicio de Sesión en formato JWT y enviando un objeto JSON con detalles relevantes para la solicitud.

PUT
https://wsventas-exp.rapifac.com/v0/comprobantes/anular




Objeto para la anulación de un comprobante

El objeto en formato JSON que se necesita para la anulación de un comprobante es el siguiente:




Descripción de los elementos del objeto
campotipoValor Ejemplodescripción
IDNumber123Este valor es el identificador del comprobante y se genera automáticamente por nuestros sistemas en el momento de la emisión del comprobante.
TipoDocumentoCodigoString01Este valor identifica el tipo de documento y su valor está determinado por los tipos de comprobantes que SUNAT acepta, estos pueden ser: - 01: Factura - 03: Boleta de Venta - 07: Nota de Crédito - 08: Nota de Debito - 09: Guía de RemisiónRemitente - 31: Guía de Remisión Transportista - 98: Cotización, este documento no escomprobante de pago,no se envía a SUNAT - 99: Orden, este documento no es comprobante de pago, no se envía a SUNAT
SerieStringF001Serie del documento, esta serie identifica a un conjunto de comprobantes, y es diferente para cada tipo de comprobante, además cada tipo decomprobante puede tener varias series.
CorrelativoNumber56Correlativo del documento, es un valor numérico secuencial que crece en una unidad para cada comprobante nuevo; además los comprobantes de una misma serie deben tener diferentes correlativos y estos deben ser secuenciales.
FechaEmisionString30/05/2022Cadena con la fecha de emisión del comprobante, esta fecha debe estar en el formato dd/mm/yyyy, esta fecha debe ser la misma fecha en la que se emite el comprobante
MotivoBajaStringError de montoCadena con el motivo de la anulación del documento
ListaDetallesArray[{ComprobanteDetalle1},{ComprobanteDetalle2}]La lista de detalles del comprobante, cada ítem del arreglo sera del tipo DetalleComprobante que se detallará mas adelante
ListaMovimientosArray[{ MovimientoCuenta1},{MovimientoCuenta2}]Arreglo de objetos de movimientos de cuentas, este objeto de detallará más adelante

Listado

Se utiliza el endpoint '/v0/comprobantes/' para listar los comprobantes emitidos según los filtros que se envían en la sección de params. La solicitud también incluye un encabezado 'Authorization' que contiene el token de autenticación JWT (JSON Web Token) entregado previamente. Los valores que van en params son:

Ejemplos de petición para obtener la lista de comprobantes

Para hacer la solicitud de tipo GET por diferentes tipos de solicitud es de la siguiente forma:

GET
https://wsventas-exp.rapifac.com/v0/comprobantes




Respuesta de la petición

El tipo de respuesta es un json y tendremos una respuesta como la siguiente:




Descripción de la respuesta
campotipoValor Ejemplodescripción
documentoString97Tipo de documento, estos son: - 00: Todos - 01: Factura - 03: Boleta de venta - 07: nota de crédito - 08: nota de debito - 99: orden - 98: cotización - 09: guía remitente - 31: guía transportista - 97: comprobantes - 96: borrador
desdeString01/02/2023Fecha de inicio para listar, la fecha tiene que estar en el formato dd/mm/yyyy
hastaString21/02/2023Fecha final para listar, la fecha tiene que estar en el formato dd/mm/yyyy
busquedaStringBúsqueda según que coincida en el valor, se puede buscar por nombre o número de documento.
sucursalInt1234Identificador de la sucursal
usuarioString1234Identificador del usuario
paginaInt1Número de pagina

Recuperar XML

Se utiliza el endpoint '/v0/comprobantes/xml?key={ComprobanteKey}' para recuperar un XML. 'ComprobanteKey' es el indentificador del XML a recuperar. Este endpoint es para obtener el XML de un comprobante emitido. La solicitud se realiza a través de HTTP utilizando el método GET.

La solicitud también incluye un encabezado “authorization” que contiene el token de autenticación JWT (JSON Web Token) entregado previamente. Los parámetros que se pasan para la consulta URL son:

GET
https://wsventas-exp.rapifac.com/v0/comprobantes/xml

El tipo de respuesta es 'application/xml', es un archivo xml.


Recuperar CDR

Se utiliza el endpoint '/v0/comprobantes/cdr?key={ComprobanteKey}' para recuperar un CDR. 'ComprobanteKey' es el identificador del CDR a recuperar. Este endpoint es para obtener el CDR de un comprobante emitido. La solicitud se realiza a través de HTTP utilizando el método GET.

La solicitud también incluye un encabezado “authorization” que contiene el token de autenticación JWT (JSON Web Token) entregado previamente. Los parámetros que se pasan para la consulta URL son:

GET
https://wsventas-exp.rapifac.com/v0/comprobantes/cdr

El tipo de respuesta es 'application/zip', es un archivo zip.


Reenviar

Ejemplos de petición para reenviar un comprobante

Se utiliza el endpoint '/v0/comprobantes/reenviar' para reenviar un documento. La solicitud también incluye un encabezado 'Authorization' que contiene el token de autenticación JWT (JSON Web Token) entregado previamente. Los valores que van en params son:

PUT
https://wsventas-exp.rapifac.com/v0/comprobantes/reenviar




Respuesta de la petición

El tipo de respuesta es un json y tendremos una respuesta con datos del XML y/o CDR como la siguiente:




Descripción de los parametros
campotipoValor Ejemplodescripción
IDInt92811ID del comprobante
RegenerarInt1Valor para hacer reenvio, estos son: - 0: Reenvio de CDR - 1: Reenvio de CDR y XML

Recuperar

Ejemplos de petición para recuperar un comprobante

Se utiliza el endpoint '/v0/comprobantes' para recuperar un comprobante. La solicitud también incluye un encabezado de 'Authorization' que contiene el token de autenticación JWT (JSON Web Token) entregado previamente. Los valores que van en params son:

Para hacer la solicitud de tipo GET por cURL es de la siguiente forma:

GET
https://wsventas-exp.rapifac.com/v0/comprobantes



Respuesta de la petición

El tipo de respuesta es un json y tendremos una respuesta como la siguiente:




Descripción de los parametros
campotipoValor Ejemplodescripción
Idlong82857Id del comprobante
TipoDocumentoString01Tipo de documento, estos son: - 98: COTIZACIONES - 99: ORDENES - 03: BOLETAS - 01: FACTURAS - 09: GUIAS REMITENTE - 31: GUIAS TRANSPORTISTA
SerieStringF001Serie del comprobante
CorrelativoInt1234Correlativo del comprobante
DetallesInt1Para recuperar los detalles del comprobante
AdicionalesInt1Para recuperar los adicionales del comprobante
MovimientosInt0Para recuperar los movimientos del comprobante

Buscar producto

Ejemplos de petición para buscar un producto

Se utiliza el endpoint '/v0/comprobantedetalles/productos' para buscar un producto. La solicitud también incluye un encabezado de 'Authorization' que contiene el token de autenticación JWT (JSON Web Token) entregado previamente.

Para hacer la solicitud de tipo GET por cURL es de la siguiente forma:

GET
https://wsventas-exp.rapifac.com/v0/comprobantedetalles/productos



Respuesta de la petición

El tipo de respuesta es un json y tendremos una respuesta como la siguiente:




Descripción de los parámetros
campotipoValor Ejemplodescripción
DescripcionStringgraNombre del producto a buscar
SucursalInt3677Id de la sucursal
PrecioConfiguracionInt1Id de precio configuración
MonedaCodigoStringPENCódigo del tipo de moneda (PEN, USD)
PaginaInt0Número de página

Recuperar producto

Ejemplos de petición para recuperar un producto

Se utiliza el endpoint '/v0/comprobanteDetalles/productos' para recuperar un producto y el endpoint '/v0/comprobanteDetalles/productosmultiples' para recuperar múltiples productos. La solicitud también incluye un encabezado de 'Authorization' que contiene el token de autenticación JWT (JSON Web Token) entregado previamente.


Para hacer la solicitud de tipo GET por cURL es de la siguiente forma:


  • Recuperar un producto
  • GET
    https://wsventas-exp.rapifac.com/v0/comprobanteDetalles/productos
  • Recuperar productos múltiples
  • GET
    https://wsventas-exp.rapifac.com/v0/comprobanteDetalles/productosmultiples



Respuesta de la petición

El tipo de respuesta es un json y tendremos una respuesta como la siguiente:

Respuesta json de un producto
Respuesta json de productos múltiples



Descripción de los parámetros
campotipoValor Ejemplodescripción
CodigoStringProd0904896Código del producto, si se recupera con productos múltiples este campo deberá ir separado entre comas de inicio a final. ejemplo: ,Prod0904897,Prod0904896,
CodigoBarrasStringProd00001Código de barras del producto (campo opcional)
PrecioConfiguracionCodigoInt1Id de precio configuración
MonedaCodigoStringPENCódigo del tipo de moneda (PEN, USD)
SucursalInt3677Id de la sucursal