Rapifac

Integración

El presente documento tiene por finalidad facilitar la integración de cualquier sistema sin importar el lenguaje de programación con el cual este desarrollado.

Para poder empezar a consumir nuestra API REST RAPIFAC, necesitamos tener los siguientes datos, usuario y contraseña, estos datos serán brindados por el área de ventas.

La ubicación de ambiente:

	Ambiente de pruebas	Ambiente de producción
Autentificación	wsoauth-p1.rapifac.com	wsoauth.rapifac.com
Emisión	wsventas-p1.rapifac.com	wsventas.rapifac.com
Comprobantes	wscomprobante-p1.rapifac.com	wscomprobante.rapifac.com

Para la autorización primero deberá solicitar un token de acceso (access_token), este le permitirá por un tiempo limitado tener acceso a los endpoints de nuestra API, 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; 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:

1. Access token vía resource owner credentials

GET

https://wsoauth-p1.rapifac.com

    GET /oauth2/token HTTP/1.1
    Host: https://wsoauth-p1.rapifac.com
    Connection: keep-alive
    Accept: application/json, text/javascript, * / *; q=0.01
    Content-Type: application/x-www-form-urlencoded
    grant_type=password&username=DNIRUC&password=PASSWORD&client_id=89cfc4c0-b0c5-47ab-a8f0-2f813dbbe000
    
    GET /oauth2/token HTTP/1.1
    Host: https://wsoauth-p1.rapifac.com
    Connection: keep-alive
    Accept: application/json, text/javascript, * / *; q=0.01
    Content-Type: application/x-www-form-urlencoded
    grant_type=password&username=DNIRUC&password=PASSWORD&client_id=89cfc4c0-b0c5-47ab-a8f0-2f813dbbe000

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:

    HTTP/1.1 200 OK
    Content-Type: application/json; charset=utf-8
    {
      "access_token": "eyJhbGciOiJodHRwOi8...",
      "token_type": "bearer",
      "expires_in": 299,
      "refresh_token": "Al6wN3QclJold5WMspI..."
    }
    
    HTTP/1.1 200 OK
    Content-Type: application/json; charset=utf-8
    {
      "access_token": "eyJhbGciOiJodHRwOi8...",
      "token_type": "bearer",
      "expires_in": 299,
      "refresh_token": "Al6wN3QclJold5WMspI..."
    }

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:

    HTTP/1.1 400 Bad Request
    Content-Type: application/json; charset=utf-8
    {
      "error": "invalid_grant",
      "error_description": "El cliente 89cfc4c0-b0c5-47ab-a8f0-2f813dbbe000 no soporta el grant_type password"
    }
    
    HTTP/1.1 400 Bad Request
    Content-Type: application/json; charset=utf-8
    {
      "error": "invalid_grant",
      "error_description": "El cliente 89cfc4c0-b0c5-47ab-a8f0-2f813dbbe000 no soporta el grant_type password"
    }

2. Access token vía refresh token

GET

https://wsoauth-p1.rapifac.com

    GET /oauth2/token HTTP/1.1
    Host: https://wsoauth-p1.rapifac.com
    Connection: keep-alive
    Accept: application/json, text/javascript, */ *; q=0.01
    Content-Type: application/x-www-form-urlencoded
    grant_type=refresh_token&refresh_token=REFRESHTOKEN&client_id=89cfc4c0-b0c5-47ab-a8f0-2f813dbbe000
    
    GET /oauth2/token HTTP/1.1
    Host: https://wsoauth-p1.rapifac.com
    Connection: keep-alive
    Accept: application/json, text/javascript, */ *; q=0.01
    Content-Type: application/x-www-form-urlencoded
    grant_type=refresh_token&refresh_token=REFRESHTOKEN&client_id=89cfc4c0-b0c5-47ab-a8f0-2f813dbbe000

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-p1.rapifac.com/v0/comprobantes

    GET /v0/comprobantes/?documento=97&desde=21/01/2022&hasta=21/02/2022&busqueda=&sucursal=50&usuario=30303032&pagina=1 HTTP/1.1
    Host: https://wsventas-p1.rapifac.com
    Connection: keep-alive
    Accept: application/json, text/javascript, */ *; q=0.01
    User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.102 Safari/537.36
    Origin: http://localhost:54764
    Accept-Encoding: gzip, deflate
    Accept-Language: es-ES,es;q=0.9
    Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3Lncz...
    
    GET /v0/comprobantes/?documento=97&desde=21/01/2022&hasta=21/02/2022&busqueda=&sucursal=50&usuario=30303032&pagina=1 HTTP/1.1
    Host: https://wsventas-p1.rapifac.com
    Connection: keep-alive
    Accept: application/json, text/javascript, */ *; q=0.01
    User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.102 Safari/537.36
    Origin: http://localhost:54764
    Accept-Encoding: gzip, deflate
    Accept-Language: es-ES,es;q=0.9
    Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3Lncz...

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

POST

https://wsoauth-p1.rapifac.com/oauth2/token

         
    curl --location --request POST 'https://wsoauth-p1.rapifac.com/oauth2/token'
    --header Content-Type: 'application/x-www-form-urlencoded'
    --data-urlencode 'grant_type=password'
    --data-urlencode 'username=DNIRUC'
    --data-urlencode 'password=CONTRASEÑA'
    --data-urlencode 'client_id=IdCliente89cfc4c0-b0c5-47ab-a8f0-2f813dbbe000'
                 
    curl --location --request POST 'https://wsoauth-p1.rapifac.com/oauth2/token'
    --header Content-Type: 'application/x-www-form-urlencoded'
    --data-urlencode 'grant_type=password'
    --data-urlencode 'username=DNIRUC'
    --data-urlencode 'password=CONTRASEÑA'
    --data-urlencode 'client_id=IdCliente89cfc4c0-b0c5-47ab-a8f0-2f813dbbe000'

Emisión de comprobantes

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-p1.rapifac.com/v0/comprobantes

  
            curl --location 'https://wsventas-p1.rapifac.com/v0/comprobantes?IncluirCDR=1' 
            --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3Lncz...'  //se agrega bearer y el token obtenido en la autentificación 
            --header 'Content-Type: application/json' 
            --data '{ /* Datos del comprobante */ }'
          
            curl --location 'https://wsventas-p1.rapifac.com/v0/comprobantes?IncluirCDR=1' 
            --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3Lncz...'  //se agrega bearer y el token obtenido en la autentificación 
            --header 'Content-Type: application/json' 
            --data '{ /* Datos del comprobante */ }'

Formato para la emisión de un comprobante

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

    {
      "ID": 0,
      "Sucursal": "3691",
      "IGVPorcentaje": 18,
      "DescuentoGlobalMonto": 0,
      "CargoGlobalPorcentaje": 0,
      "CargoGlobalIndicadorCargos": 0,
      "CargoGlobalCodigoMotivo": 0,
      "OrigenSistema": 7,
      "CondicionPago": "Contado",
      "ClienteTipoDocIdentidadCodigo": "6",
      "ClienteNumeroDocIdentidad": "20600598334",
      "ListaDetalles": [],
      "ExoneradaXML": 0,
      "InafectoXML": 0,
      "ExportacionXML": 0,
      "ImporteTotalTexto": "CIENTO DIECIOCHO CON 00/100 DOLARES",
      "DescuentoGlobalMontoBase": 100,
      "DescuentoGlobalNGMonto": 0,
      "DescuentoGlobalNGMontoBase": 0,
      "AnticiposGravado": 0,
      "AnticiposExonerado": 0,
      "AnticiposInafecto": 0,
      "CargoGlobalMonto": 0,
      "CargoGlobalMontoBase": 100,
      "ISCBase": 0,
      "GratuitoGravado": 0,
      "TotalPrecioVenta": 118,
      "TotalValorVenta": 100,
      "ListaMovimientos": [],
      "CreditoTotal": 0,
      "TipoDocumentoCodigo": "01",
      "Serie": "F002",
      "Correlativo": 1872,
      "MonedaCodigo": "USD",
      "FechaEmision": "13/02/2023",
      "TipoDocumentoCodigoModificado": "01",
      "SerieModificado": "",
      "CorrelativoModificado": "",
      "TipoNotaCreditoCodigo": "01",
      "TipoNotaDebitoCodigo": "01",
      "TipoOperacionCodigo": "0101",
      "TipoCambio": "3.919",
      "ClienteNombreRazonSocial": "RAPIFAC SOCIEDAD ANONIMA - RAPIFAC S.A.",
      "ClienteDireccion": "CAL. HIPOLITO UNANUE MZ. B LT. 1 URB. LAS MALVINAS - CUSCO - CUSCO - SANTIAGO",
      "DescuentoGlobalPorcentaje": 0,
      "DescuentoGlobalValor": 0,
      "Observacion": "",
      "Gravado": 100,
      "Exonerada": 0,
      "Inafecto": 0,
      "Exportacion": 0,
      "Gratuito": 0,
      "TotalDescuentos": 0,
      "TotalAnticipos": 0,
      "ISC": 0,
      "IGV": 18,
      "ICBPER": 0,
      "ImpuestoTotal": 18,
      "TotalOtrosCargos": 0,
      "TotalImporteVenta": 118,
      "TotalPago": 118,
      "PendientePago": "118.00"
  }
    
    {
      "ID": 0,
      "Sucursal": "3691",
      "IGVPorcentaje": 18,
      "DescuentoGlobalMonto": 0,
      "CargoGlobalPorcentaje": 0,
      "CargoGlobalIndicadorCargos": 0,
      "CargoGlobalCodigoMotivo": 0,
      "OrigenSistema": 7,
      "CondicionPago": "Contado",
      "ClienteTipoDocIdentidadCodigo": "6",
      "ClienteNumeroDocIdentidad": "20600598334",
      "ListaDetalles": [],
      "ExoneradaXML": 0,
      "InafectoXML": 0,
      "ExportacionXML": 0,
      "ImporteTotalTexto": "CIENTO DIECIOCHO CON 00/100 DOLARES",
      "DescuentoGlobalMontoBase": 100,
      "DescuentoGlobalNGMonto": 0,
      "DescuentoGlobalNGMontoBase": 0,
      "AnticiposGravado": 0,
      "AnticiposExonerado": 0,
      "AnticiposInafecto": 0,
      "CargoGlobalMonto": 0,
      "CargoGlobalMontoBase": 100,
      "ISCBase": 0,
      "GratuitoGravado": 0,
      "TotalPrecioVenta": 118,
      "TotalValorVenta": 100,
      "ListaMovimientos": [],
      "CreditoTotal": 0,
      "TipoDocumentoCodigo": "01",
      "Serie": "F002",
      "Correlativo": 1872,
      "MonedaCodigo": "USD",
      "FechaEmision": "13/02/2023",
      "TipoDocumentoCodigoModificado": "01",
      "SerieModificado": "",
      "CorrelativoModificado": "",
      "TipoNotaCreditoCodigo": "01",
      "TipoNotaDebitoCodigo": "01",
      "TipoOperacionCodigo": "0101",
      "TipoCambio": "3.919",
      "ClienteNombreRazonSocial": "RAPIFAC SOCIEDAD ANONIMA - RAPIFAC S.A.",
      "ClienteDireccion": "CAL. HIPOLITO UNANUE MZ. B LT. 1 URB. LAS MALVINAS - CUSCO - CUSCO - SANTIAGO",
      "DescuentoGlobalPorcentaje": 0,
      "DescuentoGlobalValor": 0,
      "Observacion": "",
      "Gravado": 100,
      "Exonerada": 0,
      "Inafecto": 0,
      "Exportacion": 0,
      "Gratuito": 0,
      "TotalDescuentos": 0,
      "TotalAnticipos": 0,
      "ISC": 0,
      "IGV": 18,
      "ICBPER": 0,
      "ImpuestoTotal": 18,
      "TotalOtrosCargos": 0,
      "TotalImporteVenta": 118,
      "TotalPago": 118,
      "PendientePago": "118.00"
  }

Descripción de los elementos del objeto

campo	tipo	Valor Ejemplo	descripción
ID	Number	123	Este valor es el identificador del comprobante y se genera automáticamente por NUESTRO SISTEMA en el momento de la emisión del comprobante.
Sucursal	int	1	El id que identifica a la sucursal para la cual se está emitiendo el comprobante
IGVPorcentaje	Decimal	18	Porcentaje que se aplicará a la venta (los restaurantes pueden solicitar que sea 10)
DescuentoGlobalMonto	Decimal	8.47	Descuento Global en monto pero el valor neto de los productos gravados
CargoGlobalPorcentaje	Decimal	0	El porcentaje de descuento de los productos
CargoGlobalIndicadorCargos	Bool	true	Indicador para el XML que se enviara a la SUNAT
CargoGlobalCodigoMotivo	string	46	Recargo al consumo y/o propinas
OrigenSistema	int	7	Origen del sistema
CondicionPago	string	Contado	Condición en la cual se realiza el pago del comprobante, sus valores pueden ser: Contado, Credito.
ClienteTipoDocIdentidadCodigo	string	6	Cadena 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
ClienteNumeroDocIdentidad	string	20200200201	El número del documento de identidad del cliente a quién se emite el comprobante
ListaDetalles	Array	[ ComprobanteDetalle1, ComprobanteDetalle2 ]	La lista de detalles del comprobante, cada ítem del arreglo será del tipo DetalleComprobante que se detallará más adelante.
ExoneradaXML	Decimal	0	Total(sumatoria) del valor de venta neto de los productos exonerados
InafectoXML	Decimal	0	Total(sumatoria) del valor de venta neto de los productos inafectos
ExportacionXML	Decimal	0	Total(sumatoria) del valor de venta neto de los productos de exportación
ImporteTotalTexto	string	VEINTE CON 00/100 SOLES	Importe total del comprobante en texto
DescuentoGlobalMontoBase	Decimal	16.949	Valor Neto de la venta de los productos gravados
DescuentoGlobalNGMonto	Decimal	0	Descuento Global en monto pero el valor neto de los productos no gravados
DescuentoGlobalNGMontoBase	Decimal	0	Valor Neto de la venta de los productos no gravados
AnticiposGravado	Decimal	0	Valor neto del Anticipo Gravado
AnticiposExonerado	Decimal	0	Valor neto del Anticipo Exonerado
AnticiposInafecto	Decimal	0	Valor neto del Anticipo Inafecto
CargoGlobalMonto	Decimal	0	Recargo Global en monto pero el valor neto
CargoGlobalMontoBase	Decimal	10.00	Valor Neto de la venta de los productos
ISCBase	Decimal	0	Sumatoria del ValorVentaItemXML
GratuitoGravado	Decimal	10	Total(sumatoria) del valor de venta neto de los productos
TotalPrecioVenta	Decimal	10	Total precio de venta (subtotal de la factura)
TotalValorVenta	Decimal	8.47457	Total valor de venta
ListaMovimientos	Array	[ MovimientoCuenta1, MovimientoCuenta2]	Arreglo de objetos de movimientos de cuentas, este objeto se detallará más adelante.
CreditoTotal	Decimal	10	Total de crédito del comprobante
TipoDocumentoCodigo	string	01	Tipo 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
Serie	string	F001	Serie del documento o comprobante
Correlativo	int	0001	Número correlativo del documento o comprobante
MonedaCodigo	string	PEN	Código de la moneda con la que se emitió el comprobante: PEN y USD
FechaEmision	string	30/05/2022	Cadena 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.
CorrelativoModificado	string	156	Correlativo que se modifica cuando el comprobante que se emite es de tipo 07 o 08
TipoNotaCreditoCodigo	string	01	Valor 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
TipoNotaDebitoCodigo	string	01	Valor 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
TipoOperacionCodigo	string	0101	Este 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.
TipoCambio	Number	3.78	El tipo de cambio del dólar
ClienteNombreRazonSocial	string	Libertad S.A.	Razón social del cliente a quién se emite el comprobante.
ClienteDireccion	string	Av. Siempre Viva 666	Dirección del cliente a quién se emite el comprobante.
DescuentoGlobalPorcentaje	Decimal	50	El porcentaje de descuento de los productos gravados
DescuentoGlobalValor	Decimal	10	Descuento global como monto de los productos gravados
Observacion	string	Regularización del anticipo	Campo que sirve para agregar una observación adicional al comprobante
Gravado	Decimal	8.4745	Total(sumatoria) del valor de venta de los productos gravados
Exonerada	Decimal	0	Total(sumatoria) del valor de venta de los productos exonerados
TipoDocumentoCodigoModificado	String	01	Valor 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
SerieModificado	String	F001	Serie del documento que se modifica cuando el comprobante que se emite es del tipo 07 o 08.
Inafecto	Decimal	0	Total(sumatoria) del valor de venta de los productos inafectos
Exportacion	Decimal	0	Total(sumatoria) del valor de venta de los productos exportación
Gratuito	Decimal	0	Total(sumatoria) del valor de venta de los productos gratuitos no gravados
TotalDescuentos	Decimal	8.47457	Total de los descuentos tanto global como descuento por ítem
TotalAnticipos	Decimal	0	Total de todos los anticipos
ISC	decimal	39.996399	Monto calculado después de ingresar el ISCPorcentaje
IGV	Decimal	1.525	Suma IGV de todos los ítems
ICBPER	Decimal	0	Total del Impuesto al consumo de las bolsas de plástico
ImpuestoTotal	Decimal	1.525	Total de los impuestos a pagar (IGV, ISC, ICBPER, etc)
TotalOtrosCargos	Decimal	1.525	Total de los otros cargos
TotalImporteVenta	Decimal	10	Importe total de la venta, cesión en uso o del servicio prestado
TotalPago	Decimal	10	Total a pagar
PendientePago	Decimal	10	Total pendiente de pago

Detalles

Objeto para la creación de un detalle

    {
        "ID": 0,
        "ComprobanteID": 0,
        "Item": 1,
        "ProductoCodigo": "Prod00066",
        "ProductoCodigoCliente": "Prod00066",
        "ProductoCodigoSUNAT": "39121321",
        "TipoSistemaISCCodigo": "00",
        "UnidadMedidaCodigo": "NIU",
        "PrecioUnitarioItem": 118,
        "PrecioVentaCodigo": "01",
        "ICBPER": 0,
        "DescuentoIndicador": 0,
        "PercepcionPorcentaje": 0,
        "PrecioCompra": 1.18,
        "CantidadUnidadMedida": 1,
        "Kit": false,
        "PrecioUnitarioNeto": 118,
        "Cargo": 0,
        "Descuento": 0,
        "ValorUnitario": 100,
        "ValorUnitarioNeto": 100,
        "ValorVentaItem": 100,
        "ValorVentaItemXML": 100,
        "ISC": 0,
        "IGV": 18,
        "ICBPERSubTotal": 0,
        "DescuentoBase": 100,
        "CargoItem": 0,
        "PrecioVenta": 118,
        "MontoTributo": 18,
        "ISCPorcentaje": 0,
        "CargoPorcentaje": 0,
        "Descripcion": "TECLADO GRAVADO1",
        "Observacion": "",
        "Stock": 180,
        "Cantidad": 1,
        "PrecioCodigo": 1444,
        "PrecioUnitario": "118",
        "Peso": 1,
        "DescuentoMonto": 0,
        "DescuentoPorcentaje": 0,
        "TipoAfectacionIGVCodigo": "10",
        "ValorVenta": 100,
        "ImporteTotal": 118,
        "PesoTotal": 1

  }
    
    {
        "ID": 0,
        "ComprobanteID": 0,
        "Item": 1,
        "ProductoCodigo": "Prod00066",
        "ProductoCodigoCliente": "Prod00066",
        "ProductoCodigoSUNAT": "39121321",
        "TipoSistemaISCCodigo": "00",
        "UnidadMedidaCodigo": "NIU",
        "PrecioUnitarioItem": 118,
        "PrecioVentaCodigo": "01",
        "ICBPER": 0,
        "DescuentoIndicador": 0,
        "PercepcionPorcentaje": 0,
        "PrecioCompra": 1.18,
        "CantidadUnidadMedida": 1,
        "Kit": false,
        "PrecioUnitarioNeto": 118,
        "Cargo": 0,
        "Descuento": 0,
        "ValorUnitario": 100,
        "ValorUnitarioNeto": 100,
        "ValorVentaItem": 100,
        "ValorVentaItemXML": 100,
        "ISC": 0,
        "IGV": 18,
        "ICBPERSubTotal": 0,
        "DescuentoBase": 100,
        "CargoItem": 0,
        "PrecioVenta": 118,
        "MontoTributo": 18,
        "ISCPorcentaje": 0,
        "CargoPorcentaje": 0,
        "Descripcion": "TECLADO GRAVADO1",
        "Observacion": "",
        "Stock": 180,
        "Cantidad": 1,
        "PrecioCodigo": 1444,
        "PrecioUnitario": "118",
        "Peso": 1,
        "DescuentoMonto": 0,
        "DescuentoPorcentaje": 0,
        "TipoAfectacionIGVCodigo": "10",
        "ValorVenta": 100,
        "ImporteTotal": 118,
        "PesoTotal": 1

  }

Descripción de los elementos del objeto

campo	tipo	Valor Ejemplo	descripción
ID	long	0	Número que sirve para identificar el comprobante
ComprobanteID	long	0	Número que sirve para identificar el comprobante
Item	int	1	Numeración de los detalles
ProductoCodigo	string	Prod00151	Código correlativo asignado por el sistema a un producto
ProductoCodigoCliente	string	UBI2023	Código del producto asignado por el cliente a un producto
ProductoCodigoSUNAT	string	39121321	Código de SUNAT
TipoSistemaISCCodigo	string	-01 Sistema al valor -02 Aplicación del monto fijo -03 Sistema de precios de Venta al Público	Tipo de afectación ISC para un producto
UnidadMedidaCodigo	string	valor	Abreviatura de la Unidad de Medida
PrecioUnitarioItem	decimal	236	Monto asignado con IGV de cada producto
PrecioVentaCodigo	string	0 o 1	Código de precio de venta
ICBPER	decimal	0.5	Impuesto que grava la compra de bolsas plásticas
DescuentoIndicador	string	0 o 1	Opción para escoger el tipo de descuento – 0 (%) 1 (S/.)
PercepcionPorcentaje	decimal	0	Tasa de percepción agregada a un producto
PrecioCompra	decimal	50	Monto ingresado con el cual el producto fue comprado
CantidadUnidadMedida	decimal	1	Es el número que contiene la unidad
Kit	bool	true	Producto final compuesto con varios productos
PrecioUnitarioNeto	decimal	150	Monto asignado con IMPUESTOS de cada producto con resta de los descuentos
Cargo	decimal	18.4375	Monto que resulta del valor unitario por el recargo ingresado
Descuento	decimal	40	Monto que se ingresa al sistema
ValorUnitario	decimal	200	Monto asignado sin IGV de una unidad
ValorUnitarioNeto	decimal	127.118	Monto asignado sin IMPUESTOS de cada producto con resta de los descuentos
ValorVentaItem	decimal	127.118	Monto asignado sin IGV de cada producto
ValorVentaItemXML	decimal	127.118	Monto asignado sin IGV de cada producto menos el descuento
ISC	decimal	39.996399	Monto calculado después de ingresar el ISCPorcentaje
IGV	decimal	18	Impuesto que pagan los ciudadanos al realizar una adquisición
ICBPERSubTotal	decimal	1	Sumatoria del ICBPER según la cantidad de los productos
DescuentoBase	decimal	400	Monto asignado por el sistema
CargoItem	decimal	36.875	Monto que resulta del valor unitario por el recargo ingresado
PrecioVenta	decimal	472	El monto final ingresado por el cliente
MontoTributo	decimal	66.375	IGV
ISCPorcentaje	decimal	11.11	Monto ingresado para calcular el ISC
CargoPorcentaje	decimal	10	Monto que resulta del valor unitario por el recargo ingresado
Descripcion	string	PRODUCTO GRAVADO	Detalle el nombre del producto
Observacion	string	Regularización del anticipo	Campo que sirve para agregar una observación adicional al comprobante
Stock	decimal	5	Cantidad
Cantidad	decimal	2	Número que indica el contenido del producto
PrecioCodigo	decimal	535	Código de precio
PrecioUnitario	decimal	236	Monto asignado con IGV de una unidad
Peso	decimal	1	Cantidad que indica la masa de un producto
DescuentoMonto	decimal	23.6	Es el resultado obtenido del precio final entre el descuento
DescuentoPorcentaje	decimal	10	Monto ingresado para el descuento
TipoAfectacionIGVCodigo	string	10 Gravado – Operación Onerosa	Son los distintos tipos de afectación IGV
ValorVenta	decimal	400	Monto que establece un vendedor para la adquisición de bienes o servicios que ofrece el comprador
ImporteTotal	decimal	472	Monto total
PesoTotal	decimal	1	Sumatoria total de las cantidades de todo los productos

Movimientos

Objeto para la creación de movimientos

    {
      "TipoDocumentoCodigo": "01",
      "Serie": "F001",
      "Correlativo": 1,
      "Condicion": "Contado",
      "CondicionComprobante": "Contado",
      "TipoCuentaCodigo": 1,
      "CuentaNumero": "10101010",
      "Usuario": "10101010",
      "MonedaCodigo": "PEN",
      "SucursalId": 1,
      "TipoDocIdentidadCodigo": 1,
      "NumeroDocIdentidad": "45454545",
      "Observacion": "Ventas",
      "CuentaNombre": "BCP",
      "CuentaValor": "1-10101010",
      "Pago": 100.00,
      "Vuelto": 10.00,
      "FechaPago": "08/04/2026",
      "NumeroOperacion": "0455120",
      "FechaVencimiento": "08/04/2026",
      "PlazoDias": 30
    }
    
    {
      "TipoDocumentoCodigo": "01",
      "Serie": "F001",
      "Correlativo": 1,
      "Condicion": "Contado",
      "CondicionComprobante": "Contado",
      "TipoCuentaCodigo": 1,
      "CuentaNumero": "10101010",
      "Usuario": "10101010",
      "MonedaCodigo": "PEN",
      "SucursalId": 1,
      "TipoDocIdentidadCodigo": 1,
      "NumeroDocIdentidad": "45454545",
      "Observacion": "Ventas",
      "CuentaNombre": "BCP",
      "CuentaValor": "1-10101010",
      "Pago": 100.00,
      "Vuelto": 10.00,
      "FechaPago": "08/04/2026",
      "NumeroOperacion": "0455120",
      "FechaVencimiento": "08/04/2026",
      "PlazoDias": 30
    }

Descripción de los elementos del objeto

campo	tipo	Valor Ejemplo	descripción
TipoDocumentoCodigo	String	01	Código del tipo del documento o comprobante: 01: Factura, 03: Boleta, 07: Nota de crédito, 08: Nota de débito, 99: Orden
Serie	String	F001	Serie del documento o comprobante
Correlativo	Int	1	Número correlativo del documento o comprobante
Condicion	String	Contado	Condición con la que fue emitido el comprobante: Contado o Credito
CondicionComprobante	String	Contado	Condición del comprobante recuperado con nota de crédito o débito: Contado o Credito.
TipoCuentaCodigo	Int	1	Código del tipo de cuenta, estos son: 1. Efectivo, 2. Tarjeta, 3. Banco
CuentaNumero	String	10101010	Número o código de la cuenta donde se registra el dinero.
Usuario	String	10101010	Código del usuario que emitió el comprobante
MonedaCodigo	String	PEN	Código de la moneda con la que se emitió el comprobante: PEN y USD
SucursalId	Int	1	Código de la sucursal donde se emitió el comprobante.
TipoDocIdentidadCodigo	String	1	Tipo del documento de identidad con la que se emitió el comprobante.
NumeroDocIdentidad	String	45454545	Número del documento de identidad.
Observacion	String	Ventas	Observación o descripción del comprobante emitido.
CuentaNombre	String	BCP	Nombre de la cuenta
CuentaValor	String	1-10101010	Concatenación de TipoCuentaCodigo y CuentaNumero
Pago	Decimal	100.00	Monto del importe total del comprobante.
Vuelto	Decimal	10.00	Monto del cálculo del vuelto
FechaPago	DateTime	08/02/2023	Fecha de la operación bancaria o tarjeta
NumeroOperacion	String	0455120	Número de la operación bancaria o tarjeta
FechaVencimiento	DateTime	08/03/2023	Fecha de vencimiento para comprobante emitido al crédito.
PlazoDias	Int	30	Número de días de plazo para comprobante emitido al crédito.

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:

  {
    "xml_pdf": {
        "IDComprobante": 92869,
        "Codigo": 0,
        "IDRepositorio": "zLEExc3lbkCwIHcvtuP2JA==",
        "Firma": "nLpw2MXleQkyw/223CVZTOvqUQ0=",
        "Mensaje": "01-F002-1916"
    },
    "cdr": {
        "IDComprobante": 92869,
        "Codigo": 0,
        "IDRepositorio": "19001164",
        "Firma": "",
        "Mensaje": "La Factura numero F002-1916, ha sido aceptada"
      }
  }       
  
  {
    "xml_pdf": {
        "IDComprobante": 92869,
        "Codigo": 0,
        "IDRepositorio": "zLEExc3lbkCwIHcvtuP2JA==",
        "Firma": "nLpw2MXleQkyw/223CVZTOvqUQ0=",
        "Mensaje": "01-F002-1916"
    },
    "cdr": {
        "IDComprobante": 92869,
        "Codigo": 0,
        "IDRepositorio": "19001164",
        "Firma": "",
        "Mensaje": "La Factura numero F002-1916, ha sido aceptada"
      }
  }       

Cálculos aritméticos y catalogo de tablas

Para mayor facilidad de los cálculos y la emisión, tenemos 3 archivos que serán de gran ayuda.

Factura

Ejemplos para la emision de una factura

Tenemos archivos JSON de ejemplo, para la emisión de una factura para la mayoría de casos:

Descripcion	Detalles
EMISION POR VENTA INTERNA CON OPERACION GRAVADA	Descargar Ejemplo
EMISION POR VENTA INTERNA CON DESCUENTO POR ITEM GRAVADO	Descargar Ejemplo
EMISION POR VENTA INTERNA CON OPERACION GRAVADA Y OTROS CARGOS(PROPINA)	Descargar Ejemplo
EMISION POR VENTA INTERNA CON ICBPER	Descargar Ejemplo
EMISION POR VENTA INTERNA CON OPERACION GRATUITA	Descargar Ejemplo
EMISION POR VENTA INTERNA CON OPERACIÓN EXONERADA	Descargar Ejemplo
EMISION POR VENTA INTERNA CON DESCUENTO POR ITEM EXONERADO	Descargar Ejemplo
EMISION POR VENTA INTERNA CON EXONERADO GRATUITO	Descargar Ejemplo
EMISION POR VENTA INTERNA CON OPERACIÓN INAFECTO	Descargar Ejemplo
EMISION POR VENTA INTERNA CON OPERACIÓN GRAVADA Y OPERACIÓN EXONERADA	Descargar Ejemplo
EMISION POR VENTA INTERNA CON DETRACCION	Descargar Ejemplo
EMISION POR VENTA INTERNA CON PRIMER ANTICIPO	Descargar Ejemplo
EMISION POR VENTA INTERNA CON TRES EJEMPLOS DE ITEM GRAVADOS	Descargar Ejemplo

Boleta

Ejemplos para la emision de una boleta

Tenemos archivos JSON de ejemplo, para la emisión de una boleta para la mayoría de casos:

Descripcion	Detalles
EMISION POR VENTA INTERNA CON OPERACION GRAVADA	Descargar Ejemplo
EMISION POR VENTA INTERNA CON DESCUENTO POR ITEM GRAVADO	Descargar Ejemplo
EMISION POR VENTA INTERNA CON OTROS CARGOS CON OPERACIÓN GRAVADA	Descargar Ejemplo
EMISION POR VENTA INTERNA CON ICBPER GRAVADO	Descargar Ejemplo
EMISION POR VENTA INTERNA CON OPERACIÓN GRATUITA	Descargar Ejemplo
EMISION POR VENTA INTERNA CON OPERACIÓN EXONERADA	Descargar Ejemplo
EMISION POR VENTA INTERNA CON DESCUENTO POR ITEM EXONERADO	Descargar Ejemplo
EMISION POR VENTA INTERNA CON EXONERADO GRATUITO	Descargar Ejemplo
EMISION POR VENTA INTERNA CON OPERACIÓN INAFECTO	Descargar Ejemplo

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-p1.rapifac.com/v0/comprobantes/anular

  
      curl --location --request PUT 'https://wsventas-p1.rapifac.com/v0/comprobantes/anular?IncluirCDR=1'
      --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
      --header 'Content-Type: application/json'
      --data '{ ... }'
          
      curl --location --request PUT 'https://wsventas-p1.rapifac.com/v0/comprobantes/anular?IncluirCDR=1'
      --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
      --header 'Content-Type: application/json'
      --data '{ ... }'

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:

  {
    "ID": 205100,
    "DocumentoID": "F001-1",
    "TipoDocumentoCodigo": "01",
    "Serie": "F001",
    "Correlativo": 1,
    "FechaEmision": "30/01/2024",
    "Sucursal": 3691,
    "MotivoBaja": "error al emitir",
    "ListaDetalles": [
        {
            "ID": 241232,
            "Item": 1,
            "ComprobanteID": 205100,
            "TipoDocumentoCodigo": "03",
            "Serie": "F001",
            "Correlativo": 1,
            "UnidadMedidaCodigo": "NIU",
            "Cantidad": 2,
            "ProductoCodigo": "Prod00270",
            "ProductoCodigoCliente": "Prod00270"
        }
    ],
    "ListaMovimientos": [
        {
            "CuentaNumero": "13131313",
            "Observacion": "sfdfsdf",
            "NumeroOperacion": "",
            "TipoDocumentoCodigo": "01",
            "Serie": "F001",
            "Correlativo": 1,
            "Usuario": "13131313",
            "Pago": 9.999999,
            "PlazoDias": 5,
            "Condicion": "Contado"
        }
    ]
}
  
  {
    "ID": 205100,
    "DocumentoID": "F001-1",
    "TipoDocumentoCodigo": "01",
    "Serie": "F001",
    "Correlativo": 1,
    "FechaEmision": "30/01/2024",
    "Sucursal": 3691,
    "MotivoBaja": "error al emitir",
    "ListaDetalles": [
        {
            "ID": 241232,
            "Item": 1,
            "ComprobanteID": 205100,
            "TipoDocumentoCodigo": "03",
            "Serie": "F001",
            "Correlativo": 1,
            "UnidadMedidaCodigo": "NIU",
            "Cantidad": 2,
            "ProductoCodigo": "Prod00270",
            "ProductoCodigoCliente": "Prod00270"
        }
    ],
    "ListaMovimientos": [
        {
            "CuentaNumero": "13131313",
            "Observacion": "sfdfsdf",
            "NumeroOperacion": "",
            "TipoDocumentoCodigo": "01",
            "Serie": "F001",
            "Correlativo": 1,
            "Usuario": "13131313",
            "Pago": 9.999999,
            "PlazoDias": 5,
            "Condicion": "Contado"
        }
    ]
}

Descripción de los elementos del objeto

campo	tipo	Valor Ejemplo	descripción
ID	Number	123	Este valor es el identificador del comprobante y se genera automáticamente por nuestros sistemas en el momento de la emisión del comprobante.
TipoDocumentoCodigo	String	01	Este 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
Serie	String	F001	Serie 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.
Correlativo	Number	56	Correlativo 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.
FechaEmision	String	30/05/2022	Cadena 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
MotivoBaja	String	Error de monto	Cadena con el motivo de la anulación del documento
ListaDetalles	Array	[{ComprobanteDetalle1},{ComprobanteDetalle2}]	La lista de detalles del comprobante, cada ítem del arreglo sera del tipo DetalleComprobante que se detallará mas adelante
ListaMovimientos	Array	[{ MovimientoCuenta1},{MovimientoCuenta2}]	Arreglo de objetos de movimientos de cuentas, este objeto de detallará más adelante

Anulacion mediante nota de crédito

Para la Anulacion mediante nota de crédito, se proporciona el método que se debe utilizar y algunos ejemplos para ciertos casos.

POST

https://wsventas-p1.rapifac.com/v0/comprobantes

  
            curl --location 'https://wsventas-p1.rapifac.com/v0/comprobantes' 
            --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3Lncz...'  //se agrega bearer y el token obtenido en la autentificación 
            --header 'Content-Type: application/json' 
            --data '{ /* Datos del comprobante */ }'
          
            curl --location 'https://wsventas-p1.rapifac.com/v0/comprobantes' 
            --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3Lncz...'  //se agrega bearer y el token obtenido en la autentificación 
            --header 'Content-Type: application/json' 
            --data '{ /* Datos del comprobante */ }'

Descripcion	Detalles
EMISION DE NOTA DE CREDITO DE FACTURA CON ANULACION DE LA OPERACIÓN	Descargar Ejemplo
EMISION DE NOTA DE CREDITO DE FACTURA CON DEVOLUCION POR ITEM	Descargar Ejemplo
EMISION DE NOTA DE CREDITO DE BOLETA CON ANULACION DE LA OPERACIÓN	Descargar Ejemplo
EMISION DE NOTA DE CREDITO DE BOLETA CON DEVOLUCION POR ITEM	Descargar Ejemplo

Recuperar XML

Para obtener el XML de un comprobante electrónico emitido en el Sistema Rapifac, la solicitud se realiza a través de HTTP utilizando el método GET. Para lo cual debe utilizar el endpoint '/v0/comprobantes/xml?key={ComprobanteKey}' para recuperar un XML. 'ComprobanteKey' es el indentificador del XML a recuperar.

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://wscomprobante-p1.rapifac.com/v0/comprobantes/xml

  
        curl --location --request GET 'https://wscomprobante-p1.rapifac.com/v0/comprobantes/xml?key=Z4Khpx...'
        --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
        --header 'Content-Type: application/json'
        --data '{ ... }'
          
        curl --location --request GET 'https://wscomprobante-p1.rapifac.com/v0/comprobantes/xml?key=Z4Khpx...'
        --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
        --header 'Content-Type: application/json'
        --data '{ ... }'

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

Recuperar CDR

Para obtener el CDR de un comprobante electrónico emitido en el Sistema Rapifac, la solicitud se realiza a través de HTTP utilizando el método GET. Para lo cual debe utilizar el endpoint '/v0/comprobantes/cdr?key={ComprobanteKey}' para recuperar un CDR. 'ComprobanteKey' es el indentificador del CDR a recuperar.

GET

https://wscomprobante-p1.rapifac.com/v0/comprobantes/cdr

  
            curl --location --request GET 'https://wscomprobante-p1.rapifac.com/v0/comprobantes/cdr?key=Z4Khpx...'
            --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
            --header 'Content-Type: application/json'
            --data '{ ... }'
              
            curl --location --request GET 'https://wscomprobante-p1.rapifac.com/v0/comprobantes/cdr?key=Z4Khpx...'
            --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
            --header 'Content-Type: application/json'
            --data '{ ... }'

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 los parametros son:

PUT

https://wsventas-p1.rapifac.com/v0/comprobantes/reenviar

  
        curl --location --request PUT 'https://wsventas-p1.rapifac.com/v0/comprobantes/reenviar?ID=92928&Regenerar=1'
        --header 'Authorization: Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9...'
          
        curl --location --request PUT 'https://wsventas-p1.rapifac.com/v0/comprobantes/reenviar?ID=92928&Regenerar=1'
        --header 'Authorization: Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9...'

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:

    {
        "xml_pdf": {
            "IDComprobante": 92811,
            "Codigo": 0,
            "IDRepositorio": "sS4BjwvWGQ...",
            "Firma": "+cnh+ydIm3ANl1vgsiS2...",
            "Mensaje": ""
        },
        "cdr": {
            "IDComprobante": 92811,
            "Codigo": 0,
            "IDRepositorio": "sS4BjwvWGQqz...",
            "Firma": "",
            "Mensaje": "La Factura numero F001-1, ha sido aceptada"
        }
    }
    
    {
        "xml_pdf": {
            "IDComprobante": 92811,
            "Codigo": 0,
            "IDRepositorio": "sS4BjwvWGQ...",
            "Firma": "+cnh+ydIm3ANl1vgsiS2...",
            "Mensaje": ""
        },
        "cdr": {
            "IDComprobante": 92811,
            "Codigo": 0,
            "IDRepositorio": "sS4BjwvWGQqz...",
            "Firma": "",
            "Mensaje": "La Factura numero F001-1, ha sido aceptada"
        }
    }

Descripción de los parametros

campo	tipo	Valor Ejemplo	descripción
ID	Int	92811	ID del comprobante
Regenerar	Int	1	Valor 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 los parametros son:

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

GET

https://wsventas-p1.rapifac.com/v0/comprobantes

  
        curl --location --request GET 'https://wsventas-p1.rapifac.com/v0/comprobantes?Id=195097&TipoDocumento=01&Serie=F028&Correlativo=12&TipoDocumentoSig=&Detalles=1&Adicionales=0&Pagos=1'
        --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
        --header 'Content-Type: application/json'
        --data '{ ... }'
          
        curl --location --request GET 'https://wsventas-p1.rapifac.com/v0/comprobantes?Id=195097&TipoDocumento=01&Serie=F028&Correlativo=12&TipoDocumentoSig=&Detalles=1&Adicionales=0&Pagos=1'
        --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
        --header 'Content-Type: application/json'
        --data '{ ... }'

Respuesta de la petición

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

        {
            "ID": 174876,
            "DocumentoID": "F002-10464",
            "TipoDocumentoCodigo": "01",
            "Serie": "F002",
            "Correlativo": 10464,
            "FechaEmision": "15/01/2024",
            "SeCambiaFecha": false,
            "FechaRegistro": "15/01/2024",
            "TipoOperacionCodigo": "0101",
            "TipoNotaCreditoCodigo": "01",
            "TipoNotaDebitoCodigo": "01",
            "TipoGuiaRemisionCodigo": "",
            "TipoDocumentoCodigoModificado": "01",
            "SerieModificado": "",
            "CorrelativoModificado": "0",
            "FechaEmisionModificado": "",
            "CondicionEstado": "",
            "ImporteTotalTexto": "UN CON 00/100 SOLES",
            "TransferenciaDescripcion": "",
            "PercepcionDescripcion": "",
            "DetraccionDescripcion": "",
            "AmazoniaBienesDescripcion": "",
            "AmazoniaServiciosDescripcion": "",
            "AmazoniaContratosDescripcion": "",
            "CodigoInternoDescripcion": "",
            "EmisorItineranteDescripcion": "",
            "AgenciaPaqueteDescripcion": "",
            "Observacion": "",
            "MonedaCodigo": "PEN",
            "TipoCambio": 3.696,
            "DesdeOrden": false,
            "GuiaNumero": "",
            "DUADAMCodigo": "",
            "ServicioPublicoNumero": "",
            "ServicioPublicoTipo": "",
            "ServicioPublicoCodigo": "",
            "ServicioPublicoCodigoTarifa": "",
            "ReferenciaNumeroDocumento": "",
            "ReferenciaTipoDocumento": "",
            "EmisorDocumento": "",
            "EmisorRuc": "",
            "EmisorNombreComercial": "",
            "EmisorRazonSocial": "",
            "EmisorProvincia": "",
            "EmisorDepartamento": "",
            "EmisorDistrito": "",
            "EmisorUbigeo": "",
            "EmisorCodigoPais": "",
            "EmisorDireccion": "",
            "EmisorAdicionales": null,
            "ClienteTipoDocIdentidadCodigo": "6",
            "ClienteNumeroDocIdentidad": "20406520511",
            "ClienteNombreRazonSocial": "ELECTRONIC MIHABA CORPORATION S.R.L.",
            "ClienteDireccion": "JR. PASCUAL SACO OLIVEROS Nro 873 URB. SANTA CATALINA - LIMA - LIMA - LA VICTORIA",
            "CorreoElectronicoPrincipal": null,
            "ClienteContacto": null,
            "ClienteTelefono": null,
            "ClienteUbigeo": "150115",
            "ClientePaisDocEmisor": "PE",
            "Detraccion": 0.0,
            "DetraccionCuenta": "",
            "DetraccionTipoOperacion": "",
            "DetraccionPorcentaje": 0.0,
            "BienServicioCodigo": "",
            "CondicionPago": "Contado",
            "CreditoTotal": 0.000000,
            "Percepcion": 0.0,
            "PercepcionRegimen": "",
            "PercepcionFactor": 0.0,
            "PercepcionTotal": 0.000000,
            "PercepcionBaseImponible": 0.0,
            "Retencion": 0.0,
            "MontoRetencion": 0.000000,
            "DescuentoGlobal": 0.000000,
            "DescuentoIndicador": false,
            "DescuentoGlobalMonto": 0.000000,
            "DescuentoGlobalMontoBase": 0.000000,
            "DescuentoGlobalPorcentaje": 0.00000,
            "DescuentoGlobalValor": 0.000000,
            "DescuentoGlobalIndicadorDescuento": "",
            "DescuentoGlobalCodigoMotivo": "",
            "DescuentoGlobalNGMonto": 0.000000,
            "DescuentoGlobalNGMontoBase": 1.000000,
            "DescuentoGlobalNGIndicadorDescuento": "",
            "DescuentoGlobalNGCodigoMotivo": "",
            "DescuentoNGMonto": 0.000000,
            "DescuentoGMonto": 0.0,
            "AnticiposGravado": 0.000000,
            "AnticiposExonerado": 0.000000,
            "AnticiposInafecto": 0.000000,
            "AnticipoMonto": 0.0,
            "AnticipoMontoBase": 0.0,
            "AnticipoCodigo": "",
            "CargoGlobalMonto": 0.000000,
            "CargoGlobalMontoBase": 1.000000,
            "CargoGlobalPorcentaje": 0.00000,
            "CargoGlobalIndicadorCargos": "0.000000",
            "CargoGlobalCodigoMotivo": "0",
            "ImpuestoTotal": 0.000000,
            "ISC": 0.000000,
            "ISCBase": 0.000000,
            "IGV": 0.000000,
            "IGVPorcentaje": 10.00000,
            "Gravado": 0.000000,
            "ICBPER": 0.000000,
            "Exonerada": 1.000000,
            "Inafecto": 0.000000,
            "Exportacion": 0.000000,
            "ExoneradaXML": 1.000000,
            "InafectoXML": 0.000000,
            "ExportacionXML": 0.000000,
            "Gratuito": 0.000000,
            "GratuitoGravado": 0.000000,
            "TotalImporteVenta": 1.000000,
            "TotalImporteVentaReferencia": 0.0,
            "TotalPrecioVenta": 1.000000,
            "TotalValorVenta": 1.000000,
            "TotalDescuentos": 0.000000,
            "TotalDescuentosMonto": 0.000000,
            "TotalOtrosCargos": 0.000000,
            "TotalAnticipos": 0.000000,
            "TotalPago": 1.000000,
            "TotalRestante": 1.000000,
            "PendientePago": 1.000000,
            "EnviarCorreo": false,
            "TienePDF": true,
            "TieneXML": true,
            "TieneCDR": true,
            "FormatoPDF": 0,
            "IdRepositorio": 31000443,
            "VistaDocumento": "Wm8lJz3E0zwgA8dPoNoRmg==",
            "SunatRespuesta": "0",
            "SunatMensaje": "La Factura numero F002-10464, ha sido aceptada",
            "Sucursal": 3691,
            "Usuario": "15151515",
            "Vendedor": "15151515",
            "VendedorNombre": "JASON",
            "CanalVenta": "2",
            "AlojamientoTipoDocIdentidadCodigo": "",
            "AlojamientoNumeroDocIdentidad": "",
            "AlojamientoNombreRazonSocial": "",
            "AlojamientoPaisDocEmisor": "",
            "PaisResidencia": "",
            "FechaIngresoPais": null,
            "FechaIngresoEstablecimiento": null,
            "FechaSalidaEstablecimiento": null,
            "FechaConsumo": null,
            "DiasPermanencia": 0,
            "Peso": 0.000000,
            "PesoTotal": 0.000000,
            "Bultos": 1,
            "MotivoTrasladoDescripcion": "",
            "MotivoTrasladoCodigo": "01",
            "ModalidadTrasladoCodigo": "",
            "FechaTraslado": null,
            "RemitenteTipoDocIdentidadCodigo": "",
            "RemitenteNumeroDocIdentidad": "",
            "RemitenteNombreRazonSocial": "",
            "ConductorLicencia": "",
            "TransportistaNumeroDocIdentidad": "",
            "TransportistaNombreRazonSocial": "",
            "TransportistaTipoDocIdentidadCodigo": "",
            "ConductorLicencia2": "",
            "TransportistaNumeroDocIdentidad2": "",
            "TransportistaNombreRazonSocial2": "",
            "TransportistaTipoDocIdentidadCodigo2": "",
            "VehiculoPlaca": "",
            "VehiculoCertificado": "",
            "VehiculoConfiguracion": "",
            "VehiculoAutorizacion": "",
            "VehiculoPlaca2": "",
            "VehiculoCertificado2": "",
            "VehiculoConfiguracion2": "",
            "VehiculoAutorizacion2": "",
            "VehiculoRegistrado": "",
            "VehiculoRegistradoNombre": null,
            "UbigeoLlegada": "",
            "DireccionLlegada": "",
            "NOMBRE_UBIGEOLLEGADA": "",
            "UbigeoPartida": "",
            "DireccionPartida": "",
            "NOMBRE_UBIGEOPARTIDA": "",
            "Anticipo": false,
            "EstadoContingencia": false,
            "Baja": 0,
            "Leyenda": 0,
            "LeyendaBoleta": 0,
            "LeyendaFactura": 3,
            "MotivoBaja": "",
            "OrigenSistema": 0,
            "TipoPrecio": 1,
            "Ubigeo": "150103",
            "Firma": "Mz1+zwLLa2zqLg8e57uu",
            "sIdentificadorBaja": "",
            "sIdentificadorResumen": "",
            "Estado": 0,
            "DocAdicionalCodigo": 1,
            "DocAdicionalDetalle": "",
            "PagosMultiples": false,
            "EsPrico": false,
            "RespuestaURL": "",
            "DetraccionDetalles": "",
            "DetraccionTramoLejano": 0.0,
            "DetraccionTramoCercano": 0.0,
            "DetraccionConfiguracionVehicular": "",
            "DetraccionCargaUtil": 0,
            "DetraccionCargaReal": 0.0,
            "DetraccionFactorReporno": false,
            "DetraccionValorServicioTransporte": 0.0,
            "DetraccionValorCargaEfectiva": 0.0,
            "DetraccionValorCargaUtil": 0.0,
            "RetornoEnvaseVacio": false,
            "CNG": "",
            "ListaDetalles": [
                {
                    "ID": 210824,
                    "Item": 1,
                    "ComprobanteID": 174876,
                    "TipoDocumentoCodigo": "01",
                    "Serie": "F002",
                    "Correlativo": 10464,
                    "TipoProductoCodigo": "1 ",
                    "Observacion": "",
                    "DocumentoID": "F002-10464",
                    "UnidadMedidaCodigo": "NIU",
                    "UnidadMedidaDescripcion": "UNIDAD",
                    "Cantidad": 1.000000,
                    "Descripcion": "1/8 DE POLLO A LA BRASA",
                    "ProductoCodigo": "NAND02",
                    "ProductoCodigoCliente": "NAND02",
                    "ProductoCodigoSUNAT": "41103022",
                    "PrecioUnitario": 1.000000,
                    "ValorUnitario": 1.000000,
                    "ValorUnitarioNeto": 1.000000,
                    "ValorVenta": 1.000000,
                    "PrecioUnitarioItem": 1.000000,
                    "ValorVentaItem": 1.000000,
                    "ValorVentaItemXML": 1.000000,
                    "PrecioUnitarioNeto": 1.000000,
                    "PrecioVenta": 1.000000,
                    "PrecioVentaCodigo": "02",
                    "CantidadUnidadMedida": 1.000000,
                    "Descuento": 0.000000,
                    "DescuentoBase": 1.000000,
                    "DescuentoMonto": 0.0,
                    "DescuentoPorcentaje": 0.00000,
                    "DescuentoIndicador": "0",
                    "DescuentoCargoCodigo": "01",
                    "Cargo": 0.000000,
                    "CargoBase": 0.0,
                    "CargoItem": 0.000000,
                    "CargoPorcentaje": 0.00000,
                    "CargoIndicador": "False",
                    "CargoCodigo": "",
                    "Percepcion": 0.000000,
                    "PercepcionBase": 0.000000,
                    "PercepcionPorcentaje": 0.000000,
                    "PercepcionIndicador": "",
                    "PercepcionCargoCodigo": "",
                    "PercepcionCantidadUmbral": 0.00,
                    "PercepcionMontoUmbral": 0.00,
                    "MontoTributo": 0.000000,
                    "ISC": 0.000000,
                    "ISCBase": 0.0,
                    "ISCPorcentaje": 0.00000,
                    "TipoSistemaISCCodigo": "00",
                    "PrecioUnitarioSugerido": 0.0,
                    "ICBPER": 0.000000,
                    "ICBPECantidad": 0,
                    "ICBPERSubTotal": 0.000000,
                    "TipoAfectacionIGVCodigo": "20",
                    "IGVBase": 0.0,
                    "IGV": 0.000000,
                    "IGVPorcentaje": 0.0,
                    "ImporteTotal": 1.000000,
                    "Kit": false,
                    "PrecioCompra": 1.000000,
                    "PrecioCompra_Base": 29.00000000,
                    "PrecioCompraUSD": 1.000000,
                    "PrecioCompra_BaseUSD": 7.83148800,
                    "Importado": false,
                    "CodigoCategoria": 11,
                    "Peso": 1.000000,
                    "Peso_Base": 0.0,
                    "PesoTotal": 0.000000,
                    "Control": 0,
                    "PrecioCodigo": 0,
                    "Stock": 914.000000,
                    "Vendedor": 0,
                    "ListaSeries": [],
                    "ListaPrecios": [
                        {
                            "PrecioId": 48063,
                            "PrecioConfiguracion": 1,
                            "ProductoCodigo": "NAND02",
                            "CodigoUnidadMedida": "NIU",
                            "DescripcionUnidadMedida": "UNIDAD",
                            "CantidadUnidadMedida": 1.000000,
                            "MonedaCodigo": "PEN",
                            "SucursalId": 3691,
                            "MargenGanancia": 0.000000,
                            "MargenPorcentaje": 0.000000,
                            "PrecioVenta": 1.000000,
                            "Sugerido": 0.000000,
                            "OtrosCargosPorcentaje": 0.000000,
                            "CantidadAplicable": 0.000000,
                            "FechaIngreso": "25/01/2024",
                            "FechaActualizacion": "25/01/2024",
                            "Estado": "1",
                            "ISCPorcentaje": 0.000000,
                            "ISCCalculado": 0.000000
                        },
                        {
                            "PrecioId": 48064,
                            "PrecioConfiguracion": 2,
                            "ProductoCodigo": "NAND02",
                            "CodigoUnidadMedida": "NIU",
                            "DescripcionUnidadMedida": "UNIDAD",
                            "CantidadUnidadMedida": 1.000000,
                            "MonedaCodigo": "PEN",
                            "SucursalId": 3691,
                            "MargenGanancia": 0.000000,
                            "MargenPorcentaje": 0.000000,
                            "PrecioVenta": 0.000000,
                            "Sugerido": 0.000000,
                            "OtrosCargosPorcentaje": 0.000000,
                            "CantidadAplicable": 0.000000,
                            "FechaIngreso": "25/01/2024",
                            "FechaActualizacion": "25/01/2024",
                            "Estado": "1",
                            "ISCPorcentaje": 0.000000,
                            "ISCCalculado": 0.000000
                        },
                        {
                            "PrecioId": 48065,
                            "PrecioConfiguracion": 3,
                            "ProductoCodigo": "NAND02",
                            "CodigoUnidadMedida": "NIU",
                            "DescripcionUnidadMedida": "UNIDAD",
                            "CantidadUnidadMedida": 1.000000,
                            "MonedaCodigo": "PEN",
                            "SucursalId": 3691,
                            "MargenGanancia": 0.000000,
                            "MargenPorcentaje": 0.000000,
                            "PrecioVenta": 0.000000,
                            "Sugerido": 0.000000,
                            "OtrosCargosPorcentaje": 0.000000,
                            "CantidadAplicable": 0.000000,
                            "FechaIngreso": "25/01/2024",
                            "FechaActualizacion": "25/01/2024",
                            "Estado": "1",
                            "ISCPorcentaje": 0.000000,
                            "ISCCalculado": 0.000000
                        },
                        {
                            "PrecioId": 48066,
                            "PrecioConfiguracion": 1,
                            "ProductoCodigo": "NAND02",
                            "CodigoUnidadMedida": "NIU",
                            "DescripcionUnidadMedida": "UNIDAD",
                            "CantidadUnidadMedida": 1.000000,
                            "MonedaCodigo": "USD",
                            "SucursalId": 3691,
                            "MargenGanancia": 0.000000,
                            "MargenPorcentaje": 0.000000,
                            "PrecioVenta": 1.000000,
                            "Sugerido": 0.000000,
                            "OtrosCargosPorcentaje": 0.000000,
                            "CantidadAplicable": 0.000000,
                            "FechaIngreso": "25/01/2024",
                            "FechaActualizacion": "25/01/2024",
                            "Estado": "1",
                            "ISCPorcentaje": 0.000000,
                            "ISCCalculado": 0.000000
                        },
                        {
                            "PrecioId": 48067,
                            "PrecioConfiguracion": 2,
                            "ProductoCodigo": "NAND02",
                            "CodigoUnidadMedida": "NIU",
                            "DescripcionUnidadMedida": "UNIDAD",
                            "CantidadUnidadMedida": 1.000000,
                            "MonedaCodigo": "USD",
                            "SucursalId": 3691,
                            "MargenGanancia": 0.000000,
                            "MargenPorcentaje": 0.000000,
                            "PrecioVenta": 0.000000,
                            "Sugerido": 0.000000,
                            "OtrosCargosPorcentaje": 0.000000,
                            "CantidadAplicable": 0.000000,
                            "FechaIngreso": "25/01/2024",
                            "FechaActualizacion": "25/01/2024",
                            "Estado": "1",
                            "ISCPorcentaje": 0.000000,
                            "ISCCalculado": 0.000000
                        },
                        {
                            "PrecioId": 48068,
                            "PrecioConfiguracion": 3,
                            "ProductoCodigo": "NAND02",
                            "CodigoUnidadMedida": "NIU",
                            "DescripcionUnidadMedida": "UNIDAD",
                            "CantidadUnidadMedida": 1.000000,
                            "MonedaCodigo": "USD",
                            "SucursalId": 3691,
                            "MargenGanancia": 0.000000,
                            "MargenPorcentaje": 0.000000,
                            "PrecioVenta": 0.000000,
                            "Sugerido": 0.000000,
                            "OtrosCargosPorcentaje": 0.000000,
                            "CantidadAplicable": 0.000000,
                            "FechaIngreso": "25/01/2024",
                            "FechaActualizacion": "25/01/2024",
                            "Estado": "1",
                            "ISCPorcentaje": 0.000000,
                            "ISCCalculado": 0.000000
                        }
                    ]
                }
            ],
            "ListaAnticipos": [],
            "ListaCuotas": [],
            "ListaGuias": [],
            "ListaMovimientos": [
                {
                    "IdMovimiento": 94811,
                    "TipoCuentaCodigo": 3,
                    "CuentaNumero": "12547856931",
                    "CuentaNombre": "BCPAAA",
                    "TipoIngresoEgreso": 1,
                    "MontoPagar": 1.000000,
                    "MonedaCodigo": "PEN",
                    "Observacion": "INGRESO VENTAS",
                    "NumeroOperacion": "1324567896",
                    "TipoDocIdentidadCodigo": "6",
                    "NumeroDocIdentidad": "20406520511",
                    "Origen": "VENTAS",
                    "TipoDocumentoCodigo": "01",
                    "Serie": "F002",
                    "Correlativo": 10464,
                    "Usuario": "15151515",
                    "IdOrigen": 1,
                    "Estado": 1,
                    "FechaPago": "15/01/2024",
                    "SucursalId": 0,
                    "Pago": 1.000000,
                    "Pagado": 0.000000,
                    "Saldo": 0.000000,
                    "FechaVencimiento": "01/01/1900",
                    "PlazoDias": 0,
                    "CondicionComprobante": "Contado",
                    "Condicion": "Contado",
                    "Vuelto": 0.0,
                    "CondicionPagoModificado": "",
                    "CuentaNumeroModificado": "",
                    "CuentaTipoModificado": "",
                    "FechaMovimiento": ""
                }
            ],
            "ListaDocumentosRelacionados": [],
            "ListaCondicionesComerciales": null
        }
        
        {
            "ID": 174876,
            "DocumentoID": "F002-10464",
            "TipoDocumentoCodigo": "01",
            "Serie": "F002",
            "Correlativo": 10464,
            "FechaEmision": "15/01/2024",
            "SeCambiaFecha": false,
            "FechaRegistro": "15/01/2024",
            "TipoOperacionCodigo": "0101",
            "TipoNotaCreditoCodigo": "01",
            "TipoNotaDebitoCodigo": "01",
            "TipoGuiaRemisionCodigo": "",
            "TipoDocumentoCodigoModificado": "01",
            "SerieModificado": "",
            "CorrelativoModificado": "0",
            "FechaEmisionModificado": "",
            "CondicionEstado": "",
            "ImporteTotalTexto": "UN CON 00/100 SOLES",
            "TransferenciaDescripcion": "",
            "PercepcionDescripcion": "",
            "DetraccionDescripcion": "",
            "AmazoniaBienesDescripcion": "",
            "AmazoniaServiciosDescripcion": "",
            "AmazoniaContratosDescripcion": "",
            "CodigoInternoDescripcion": "",
            "EmisorItineranteDescripcion": "",
            "AgenciaPaqueteDescripcion": "",
            "Observacion": "",
            "MonedaCodigo": "PEN",
            "TipoCambio": 3.696,
            "DesdeOrden": false,
            "GuiaNumero": "",
            "DUADAMCodigo": "",
            "ServicioPublicoNumero": "",
            "ServicioPublicoTipo": "",
            "ServicioPublicoCodigo": "",
            "ServicioPublicoCodigoTarifa": "",
            "ReferenciaNumeroDocumento": "",
            "ReferenciaTipoDocumento": "",
            "EmisorDocumento": "",
            "EmisorRuc": "",
            "EmisorNombreComercial": "",
            "EmisorRazonSocial": "",
            "EmisorProvincia": "",
            "EmisorDepartamento": "",
            "EmisorDistrito": "",
            "EmisorUbigeo": "",
            "EmisorCodigoPais": "",
            "EmisorDireccion": "",
            "EmisorAdicionales": null,
            "ClienteTipoDocIdentidadCodigo": "6",
            "ClienteNumeroDocIdentidad": "20406520511",
            "ClienteNombreRazonSocial": "ELECTRONIC MIHABA CORPORATION S.R.L.",
            "ClienteDireccion": "JR. PASCUAL SACO OLIVEROS Nro 873 URB. SANTA CATALINA - LIMA - LIMA - LA VICTORIA",
            "CorreoElectronicoPrincipal": null,
            "ClienteContacto": null,
            "ClienteTelefono": null,
            "ClienteUbigeo": "150115",
            "ClientePaisDocEmisor": "PE",
            "Detraccion": 0.0,
            "DetraccionCuenta": "",
            "DetraccionTipoOperacion": "",
            "DetraccionPorcentaje": 0.0,
            "BienServicioCodigo": "",
            "CondicionPago": "Contado",
            "CreditoTotal": 0.000000,
            "Percepcion": 0.0,
            "PercepcionRegimen": "",
            "PercepcionFactor": 0.0,
            "PercepcionTotal": 0.000000,
            "PercepcionBaseImponible": 0.0,
            "Retencion": 0.0,
            "MontoRetencion": 0.000000,
            "DescuentoGlobal": 0.000000,
            "DescuentoIndicador": false,
            "DescuentoGlobalMonto": 0.000000,
            "DescuentoGlobalMontoBase": 0.000000,
            "DescuentoGlobalPorcentaje": 0.00000,
            "DescuentoGlobalValor": 0.000000,
            "DescuentoGlobalIndicadorDescuento": "",
            "DescuentoGlobalCodigoMotivo": "",
            "DescuentoGlobalNGMonto": 0.000000,
            "DescuentoGlobalNGMontoBase": 1.000000,
            "DescuentoGlobalNGIndicadorDescuento": "",
            "DescuentoGlobalNGCodigoMotivo": "",
            "DescuentoNGMonto": 0.000000,
            "DescuentoGMonto": 0.0,
            "AnticiposGravado": 0.000000,
            "AnticiposExonerado": 0.000000,
            "AnticiposInafecto": 0.000000,
            "AnticipoMonto": 0.0,
            "AnticipoMontoBase": 0.0,
            "AnticipoCodigo": "",
            "CargoGlobalMonto": 0.000000,
            "CargoGlobalMontoBase": 1.000000,
            "CargoGlobalPorcentaje": 0.00000,
            "CargoGlobalIndicadorCargos": "0.000000",
            "CargoGlobalCodigoMotivo": "0",
            "ImpuestoTotal": 0.000000,
            "ISC": 0.000000,
            "ISCBase": 0.000000,
            "IGV": 0.000000,
            "IGVPorcentaje": 10.00000,
            "Gravado": 0.000000,
            "ICBPER": 0.000000,
            "Exonerada": 1.000000,
            "Inafecto": 0.000000,
            "Exportacion": 0.000000,
            "ExoneradaXML": 1.000000,
            "InafectoXML": 0.000000,
            "ExportacionXML": 0.000000,
            "Gratuito": 0.000000,
            "GratuitoGravado": 0.000000,
            "TotalImporteVenta": 1.000000,
            "TotalImporteVentaReferencia": 0.0,
            "TotalPrecioVenta": 1.000000,
            "TotalValorVenta": 1.000000,
            "TotalDescuentos": 0.000000,
            "TotalDescuentosMonto": 0.000000,
            "TotalOtrosCargos": 0.000000,
            "TotalAnticipos": 0.000000,
            "TotalPago": 1.000000,
            "TotalRestante": 1.000000,
            "PendientePago": 1.000000,
            "EnviarCorreo": false,
            "TienePDF": true,
            "TieneXML": true,
            "TieneCDR": true,
            "FormatoPDF": 0,
            "IdRepositorio": 31000443,
            "VistaDocumento": "Wm8lJz3E0zwgA8dPoNoRmg==",
            "SunatRespuesta": "0",
            "SunatMensaje": "La Factura numero F002-10464, ha sido aceptada",
            "Sucursal": 3691,
            "Usuario": "15151515",
            "Vendedor": "15151515",
            "VendedorNombre": "JASON",
            "CanalVenta": "2",
            "AlojamientoTipoDocIdentidadCodigo": "",
            "AlojamientoNumeroDocIdentidad": "",
            "AlojamientoNombreRazonSocial": "",
            "AlojamientoPaisDocEmisor": "",
            "PaisResidencia": "",
            "FechaIngresoPais": null,
            "FechaIngresoEstablecimiento": null,
            "FechaSalidaEstablecimiento": null,
            "FechaConsumo": null,
            "DiasPermanencia": 0,
            "Peso": 0.000000,
            "PesoTotal": 0.000000,
            "Bultos": 1,
            "MotivoTrasladoDescripcion": "",
            "MotivoTrasladoCodigo": "01",
            "ModalidadTrasladoCodigo": "",
            "FechaTraslado": null,
            "RemitenteTipoDocIdentidadCodigo": "",
            "RemitenteNumeroDocIdentidad": "",
            "RemitenteNombreRazonSocial": "",
            "ConductorLicencia": "",
            "TransportistaNumeroDocIdentidad": "",
            "TransportistaNombreRazonSocial": "",
            "TransportistaTipoDocIdentidadCodigo": "",
            "ConductorLicencia2": "",
            "TransportistaNumeroDocIdentidad2": "",
            "TransportistaNombreRazonSocial2": "",
            "TransportistaTipoDocIdentidadCodigo2": "",
            "VehiculoPlaca": "",
            "VehiculoCertificado": "",
            "VehiculoConfiguracion": "",
            "VehiculoAutorizacion": "",
            "VehiculoPlaca2": "",
            "VehiculoCertificado2": "",
            "VehiculoConfiguracion2": "",
            "VehiculoAutorizacion2": "",
            "VehiculoRegistrado": "",
            "VehiculoRegistradoNombre": null,
            "UbigeoLlegada": "",
            "DireccionLlegada": "",
            "NOMBRE_UBIGEOLLEGADA": "",
            "UbigeoPartida": "",
            "DireccionPartida": "",
            "NOMBRE_UBIGEOPARTIDA": "",
            "Anticipo": false,
            "EstadoContingencia": false,
            "Baja": 0,
            "Leyenda": 0,
            "LeyendaBoleta": 0,
            "LeyendaFactura": 3,
            "MotivoBaja": "",
            "OrigenSistema": 0,
            "TipoPrecio": 1,
            "Ubigeo": "150103",
            "Firma": "Mz1+zwLLa2zqLg8e57uu",
            "sIdentificadorBaja": "",
            "sIdentificadorResumen": "",
            "Estado": 0,
            "DocAdicionalCodigo": 1,
            "DocAdicionalDetalle": "",
            "PagosMultiples": false,
            "EsPrico": false,
            "RespuestaURL": "",
            "DetraccionDetalles": "",
            "DetraccionTramoLejano": 0.0,
            "DetraccionTramoCercano": 0.0,
            "DetraccionConfiguracionVehicular": "",
            "DetraccionCargaUtil": 0,
            "DetraccionCargaReal": 0.0,
            "DetraccionFactorReporno": false,
            "DetraccionValorServicioTransporte": 0.0,
            "DetraccionValorCargaEfectiva": 0.0,
            "DetraccionValorCargaUtil": 0.0,
            "RetornoEnvaseVacio": false,
            "CNG": "",
            "ListaDetalles": [
                {
                    "ID": 210824,
                    "Item": 1,
                    "ComprobanteID": 174876,
                    "TipoDocumentoCodigo": "01",
                    "Serie": "F002",
                    "Correlativo": 10464,
                    "TipoProductoCodigo": "1 ",
                    "Observacion": "",
                    "DocumentoID": "F002-10464",
                    "UnidadMedidaCodigo": "NIU",
                    "UnidadMedidaDescripcion": "UNIDAD",
                    "Cantidad": 1.000000,
                    "Descripcion": "1/8 DE POLLO A LA BRASA",
                    "ProductoCodigo": "NAND02",
                    "ProductoCodigoCliente": "NAND02",
                    "ProductoCodigoSUNAT": "41103022",
                    "PrecioUnitario": 1.000000,
                    "ValorUnitario": 1.000000,
                    "ValorUnitarioNeto": 1.000000,
                    "ValorVenta": 1.000000,
                    "PrecioUnitarioItem": 1.000000,
                    "ValorVentaItem": 1.000000,
                    "ValorVentaItemXML": 1.000000,
                    "PrecioUnitarioNeto": 1.000000,
                    "PrecioVenta": 1.000000,
                    "PrecioVentaCodigo": "02",
                    "CantidadUnidadMedida": 1.000000,
                    "Descuento": 0.000000,
                    "DescuentoBase": 1.000000,
                    "DescuentoMonto": 0.0,
                    "DescuentoPorcentaje": 0.00000,
                    "DescuentoIndicador": "0",
                    "DescuentoCargoCodigo": "01",
                    "Cargo": 0.000000,
                    "CargoBase": 0.0,
                    "CargoItem": 0.000000,
                    "CargoPorcentaje": 0.00000,
                    "CargoIndicador": "False",
                    "CargoCodigo": "",
                    "Percepcion": 0.000000,
                    "PercepcionBase": 0.000000,
                    "PercepcionPorcentaje": 0.000000,
                    "PercepcionIndicador": "",
                    "PercepcionCargoCodigo": "",
                    "PercepcionCantidadUmbral": 0.00,
                    "PercepcionMontoUmbral": 0.00,
                    "MontoTributo": 0.000000,
                    "ISC": 0.000000,
                    "ISCBase": 0.0,
                    "ISCPorcentaje": 0.00000,
                    "TipoSistemaISCCodigo": "00",
                    "PrecioUnitarioSugerido": 0.0,
                    "ICBPER": 0.000000,
                    "ICBPECantidad": 0,
                    "ICBPERSubTotal": 0.000000,
                    "TipoAfectacionIGVCodigo": "20",
                    "IGVBase": 0.0,
                    "IGV": 0.000000,
                    "IGVPorcentaje": 0.0,
                    "ImporteTotal": 1.000000,
                    "Kit": false,
                    "PrecioCompra": 1.000000,
                    "PrecioCompra_Base": 29.00000000,
                    "PrecioCompraUSD": 1.000000,
                    "PrecioCompra_BaseUSD": 7.83148800,
                    "Importado": false,
                    "CodigoCategoria": 11,
                    "Peso": 1.000000,
                    "Peso_Base": 0.0,
                    "PesoTotal": 0.000000,
                    "Control": 0,
                    "PrecioCodigo": 0,
                    "Stock": 914.000000,
                    "Vendedor": 0,
                    "ListaSeries": [],
                    "ListaPrecios": [
                        {
                            "PrecioId": 48063,
                            "PrecioConfiguracion": 1,
                            "ProductoCodigo": "NAND02",
                            "CodigoUnidadMedida": "NIU",
                            "DescripcionUnidadMedida": "UNIDAD",
                            "CantidadUnidadMedida": 1.000000,
                            "MonedaCodigo": "PEN",
                            "SucursalId": 3691,
                            "MargenGanancia": 0.000000,
                            "MargenPorcentaje": 0.000000,
                            "PrecioVenta": 1.000000,
                            "Sugerido": 0.000000,
                            "OtrosCargosPorcentaje": 0.000000,
                            "CantidadAplicable": 0.000000,
                            "FechaIngreso": "25/01/2024",
                            "FechaActualizacion": "25/01/2024",
                            "Estado": "1",
                            "ISCPorcentaje": 0.000000,
                            "ISCCalculado": 0.000000
                        },
                        {
                            "PrecioId": 48064,
                            "PrecioConfiguracion": 2,
                            "ProductoCodigo": "NAND02",
                            "CodigoUnidadMedida": "NIU",
                            "DescripcionUnidadMedida": "UNIDAD",
                            "CantidadUnidadMedida": 1.000000,
                            "MonedaCodigo": "PEN",
                            "SucursalId": 3691,
                            "MargenGanancia": 0.000000,
                            "MargenPorcentaje": 0.000000,
                            "PrecioVenta": 0.000000,
                            "Sugerido": 0.000000,
                            "OtrosCargosPorcentaje": 0.000000,
                            "CantidadAplicable": 0.000000,
                            "FechaIngreso": "25/01/2024",
                            "FechaActualizacion": "25/01/2024",
                            "Estado": "1",
                            "ISCPorcentaje": 0.000000,
                            "ISCCalculado": 0.000000
                        },
                        {
                            "PrecioId": 48065,
                            "PrecioConfiguracion": 3,
                            "ProductoCodigo": "NAND02",
                            "CodigoUnidadMedida": "NIU",
                            "DescripcionUnidadMedida": "UNIDAD",
                            "CantidadUnidadMedida": 1.000000,
                            "MonedaCodigo": "PEN",
                            "SucursalId": 3691,
                            "MargenGanancia": 0.000000,
                            "MargenPorcentaje": 0.000000,
                            "PrecioVenta": 0.000000,
                            "Sugerido": 0.000000,
                            "OtrosCargosPorcentaje": 0.000000,
                            "CantidadAplicable": 0.000000,
                            "FechaIngreso": "25/01/2024",
                            "FechaActualizacion": "25/01/2024",
                            "Estado": "1",
                            "ISCPorcentaje": 0.000000,
                            "ISCCalculado": 0.000000
                        },
                        {
                            "PrecioId": 48066,
                            "PrecioConfiguracion": 1,
                            "ProductoCodigo": "NAND02",
                            "CodigoUnidadMedida": "NIU",
                            "DescripcionUnidadMedida": "UNIDAD",
                            "CantidadUnidadMedida": 1.000000,
                            "MonedaCodigo": "USD",
                            "SucursalId": 3691,
                            "MargenGanancia": 0.000000,
                            "MargenPorcentaje": 0.000000,
                            "PrecioVenta": 1.000000,
                            "Sugerido": 0.000000,
                            "OtrosCargosPorcentaje": 0.000000,
                            "CantidadAplicable": 0.000000,
                            "FechaIngreso": "25/01/2024",
                            "FechaActualizacion": "25/01/2024",
                            "Estado": "1",
                            "ISCPorcentaje": 0.000000,
                            "ISCCalculado": 0.000000
                        },
                        {
                            "PrecioId": 48067,
                            "PrecioConfiguracion": 2,
                            "ProductoCodigo": "NAND02",
                            "CodigoUnidadMedida": "NIU",
                            "DescripcionUnidadMedida": "UNIDAD",
                            "CantidadUnidadMedida": 1.000000,
                            "MonedaCodigo": "USD",
                            "SucursalId": 3691,
                            "MargenGanancia": 0.000000,
                            "MargenPorcentaje": 0.000000,
                            "PrecioVenta": 0.000000,
                            "Sugerido": 0.000000,
                            "OtrosCargosPorcentaje": 0.000000,
                            "CantidadAplicable": 0.000000,
                            "FechaIngreso": "25/01/2024",
                            "FechaActualizacion": "25/01/2024",
                            "Estado": "1",
                            "ISCPorcentaje": 0.000000,
                            "ISCCalculado": 0.000000
                        },
                        {
                            "PrecioId": 48068,
                            "PrecioConfiguracion": 3,
                            "ProductoCodigo": "NAND02",
                            "CodigoUnidadMedida": "NIU",
                            "DescripcionUnidadMedida": "UNIDAD",
                            "CantidadUnidadMedida": 1.000000,
                            "MonedaCodigo": "USD",
                            "SucursalId": 3691,
                            "MargenGanancia": 0.000000,
                            "MargenPorcentaje": 0.000000,
                            "PrecioVenta": 0.000000,
                            "Sugerido": 0.000000,
                            "OtrosCargosPorcentaje": 0.000000,
                            "CantidadAplicable": 0.000000,
                            "FechaIngreso": "25/01/2024",
                            "FechaActualizacion": "25/01/2024",
                            "Estado": "1",
                            "ISCPorcentaje": 0.000000,
                            "ISCCalculado": 0.000000
                        }
                    ]
                }
            ],
            "ListaAnticipos": [],
            "ListaCuotas": [],
            "ListaGuias": [],
            "ListaMovimientos": [
                {
                    "IdMovimiento": 94811,
                    "TipoCuentaCodigo": 3,
                    "CuentaNumero": "12547856931",
                    "CuentaNombre": "BCPAAA",
                    "TipoIngresoEgreso": 1,
                    "MontoPagar": 1.000000,
                    "MonedaCodigo": "PEN",
                    "Observacion": "INGRESO VENTAS",
                    "NumeroOperacion": "1324567896",
                    "TipoDocIdentidadCodigo": "6",
                    "NumeroDocIdentidad": "20406520511",
                    "Origen": "VENTAS",
                    "TipoDocumentoCodigo": "01",
                    "Serie": "F002",
                    "Correlativo": 10464,
                    "Usuario": "15151515",
                    "IdOrigen": 1,
                    "Estado": 1,
                    "FechaPago": "15/01/2024",
                    "SucursalId": 0,
                    "Pago": 1.000000,
                    "Pagado": 0.000000,
                    "Saldo": 0.000000,
                    "FechaVencimiento": "01/01/1900",
                    "PlazoDias": 0,
                    "CondicionComprobante": "Contado",
                    "Condicion": "Contado",
                    "Vuelto": 0.0,
                    "CondicionPagoModificado": "",
                    "CuentaNumeroModificado": "",
                    "CuentaTipoModificado": "",
                    "FechaMovimiento": ""
                }
            ],
            "ListaDocumentosRelacionados": [],
            "ListaCondicionesComerciales": null
        }

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-p1.rapifac.com/v0/comprobantedetalles/productos

  
        curl --location --request GET 'https://wsventas-p1.rapifac.com/v0/comprobantedetalles/productos?Descripcion=gra&Sucursal=3677&PrecioConfiguracion=1&MonedaCodigo=PEN&Pagina=0'
        --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
        --header 'Content-Type: application/json'
        --data '{ ... }'
          
        curl --location --request GET 'https://wsventas-p1.rapifac.com/v0/comprobantedetalles/productos?Descripcion=gra&Sucursal=3677&PrecioConfiguracion=1&MonedaCodigo=PEN&Pagina=0'
        --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
        --header 'Content-Type: application/json'
        --data '{ ... }'

Respuesta de la petición

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

        {
            "TotalItems": 149,
            "ItemsPorPagina": 20,
            "PaginaActual": 1,
            "TotalPaginas": 8,
            "SumaTotal": 0.0,
            "ListaItems": [
                {
                    "Codigo": "Prod0904896",
                    "CodigoCliente": "Prod0904896",
                    "Descripcion": "00 PRODUCTO GRAVADO",
                    "Stock": 321,
                    "PrecioUnitario": 11.80,
                    "MonedaCodigo": "PEN",
                    "UbicacionDescripcion": ""
                },
                {
                    "Codigo": "Prod0904738",
                    "CodigoCliente": "silvi01",
                    "Descripcion": "0001 GRAVADO COMPRAS",
                    "Stock": -133,
                    "PrecioUnitario": 180.00,
                    "MonedaCodigo": "PEN",
                    "UbicacionDescripcion": ""
                },
                .
                .
                .
            ]
        }
        
        {
            "TotalItems": 149,
            "ItemsPorPagina": 20,
            "PaginaActual": 1,
            "TotalPaginas": 8,
            "SumaTotal": 0.0,
            "ListaItems": [
                {
                    "Codigo": "Prod0904896",
                    "CodigoCliente": "Prod0904896",
                    "Descripcion": "00 PRODUCTO GRAVADO",
                    "Stock": 321,
                    "PrecioUnitario": 11.80,
                    "MonedaCodigo": "PEN",
                    "UbicacionDescripcion": ""
                },
                {
                    "Codigo": "Prod0904738",
                    "CodigoCliente": "silvi01",
                    "Descripcion": "0001 GRAVADO COMPRAS",
                    "Stock": -133,
                    "PrecioUnitario": 180.00,
                    "MonedaCodigo": "PEN",
                    "UbicacionDescripcion": ""
                },
                .
                .
                .
            ]
        }

Descripción de los parámetros

campo	tipo	Valor Ejemplo	descripción
Descripcion	String	gra	Nombre del producto a buscar
Sucursal	Int	3677	Id de la sucursal
PrecioConfiguracion	Int	1	Id de precio configuración
MonedaCodigo	String	PEN	Código del tipo de moneda (PEN, USD)
Pagina	Int	0	Nú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-p1.rapifac.com/v0/comprobanteDetalles/productos

  
        curl --location --request GET 'https://wsventas-p1.rapifac.com/v0/comprobanteDetalles/productos?Codigo=Prod0904946&CodigoBarras=&PrecioConfiguracionCodigo=1&MonedaCodigo=PEN&Sucursal=3677'
        --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
        --header 'Content-Type: application/json'
        --data '{ ... }'
          
        curl --location --request GET 'https://wsventas-p1.rapifac.com/v0/comprobanteDetalles/productos?Codigo=Prod0904946&CodigoBarras=&PrecioConfiguracionCodigo=1&MonedaCodigo=PEN&Sucursal=3677'
        --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
        --header 'Content-Type: application/json'
        --data '{ ... }'

Recuperar productos múltiples

GET

https://wsventas-p1.rapifac.com/v0/comprobanteDetalles/productosmultiples

  
            curl --location --request GET 'https://wsventas-p1.rapifac.com/v0/comprobanteDetalles/productosmultiples?Codigo=%2CProd0904897%2CProd0904896%2C&CodigoBarras=&PrecioConfiguracionCodigo=1&MonedaCodigo=PEN&Sucursal=3677'
            --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
            --header 'Content-Type: application/json'
            --data '{ ... }'
              
            curl --location --request GET 'https://wsventas-p1.rapifac.com/v0/comprobanteDetalles/productosmultiples?Codigo=%2CProd0904897%2CProd0904896%2C&CodigoBarras=&PrecioConfiguracionCodigo=1&MonedaCodigo=PEN&Sucursal=3677'
            --header 'Authorization: bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9...
            --header 'Content-Type: application/json'
            --data '{ ... }'

Respuesta de la petición

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

Respuesta json de un producto

        {
            "TipoProducto": "1",
            "ProductoCodigo": "Prod0904946",
            "ProductoCodigoSUNAT": "56112005",
            "ProductoDescripcion": "14 ENERO GRAV",
            "ProductoCodigoCliente": "ENERO14",
            "Observacion": "",
            "TipoAfectacionIGVCodigo": "10",
            "TipoSistemaISCCodigo": "00",
            "CodigoCategoria": 0,
            "Stock": 10.000000,
            "Cantidad": 1,
            "PrecioCodigo": "114985",
            "CantidadUnidadMedida": 1.000000,
            "UnidadMedidaCodigo": "NIU",
            "PrecioUnitario": 0.000000,
            "PrecioUnitarioSugerido": 0.00,
            "ICBPER": 0.000000000,
            "DescuentoIndicador": 0,
            "Descuento": 0,
            "DescuentoPorcentaje": 0,
            "DescuentoCargoCodigo": 0,
            "PercepcionCantidadUmbral": 0,
            "PercepcionMontoUmbral": 0.00,
            "PercepcionPorcentaje": 0.00,
            "Control": "0",
            "ValorUnitario": 0.00,
            "AplicaISC": false,
            "AplicaOtrosCargos": false,
            "AplicaICBPER": false,
            "Peso": 1.0,
            "Kit": false,
            "PrecioCompra": 200.000000,
            "ListaPrecios": [
                {
                    "PrecioId": 114985,
                    "PrecioConfiguracion": 1,
                    "ProductoCodigo": "Prod0904946",
                    "CodigoUnidadMedida": "NIU",
                    "DescripcionUnidadMedida": "UNIDAD",
                    "CantidadUnidadMedida": 1.000000,
                    "MonedaCodigo": "PEN",
                    "SucursalId": 3677,
                    "MargenGanancia": 0.000000,
                    "MargenPorcentaje": 0.000000,
                    "PrecioVenta": 0.000000,
                    "Sugerido": 0.000000,
                    "OtrosCargosPorcentaje": 0.000000,
                    "CantidadAplicable": 1.000000,
                    "FechaIngreso": "14/01/2023",
                    "FechaActualizacion": "14/01/2023",
                    "Estado": "1",
                    "ISCPorcentaje": 0.000000,
                    "ISCCalculado": 0.000000
                },
                .
                .
                .
            ]
        }
        
        {
            "TipoProducto": "1",
            "ProductoCodigo": "Prod0904946",
            "ProductoCodigoSUNAT": "56112005",
            "ProductoDescripcion": "14 ENERO GRAV",
            "ProductoCodigoCliente": "ENERO14",
            "Observacion": "",
            "TipoAfectacionIGVCodigo": "10",
            "TipoSistemaISCCodigo": "00",
            "CodigoCategoria": 0,
            "Stock": 10.000000,
            "Cantidad": 1,
            "PrecioCodigo": "114985",
            "CantidadUnidadMedida": 1.000000,
            "UnidadMedidaCodigo": "NIU",
            "PrecioUnitario": 0.000000,
            "PrecioUnitarioSugerido": 0.00,
            "ICBPER": 0.000000000,
            "DescuentoIndicador": 0,
            "Descuento": 0,
            "DescuentoPorcentaje": 0,
            "DescuentoCargoCodigo": 0,
            "PercepcionCantidadUmbral": 0,
            "PercepcionMontoUmbral": 0.00,
            "PercepcionPorcentaje": 0.00,
            "Control": "0",
            "ValorUnitario": 0.00,
            "AplicaISC": false,
            "AplicaOtrosCargos": false,
            "AplicaICBPER": false,
            "Peso": 1.0,
            "Kit": false,
            "PrecioCompra": 200.000000,
            "ListaPrecios": [
                {
                    "PrecioId": 114985,
                    "PrecioConfiguracion": 1,
                    "ProductoCodigo": "Prod0904946",
                    "CodigoUnidadMedida": "NIU",
                    "DescripcionUnidadMedida": "UNIDAD",
                    "CantidadUnidadMedida": 1.000000,
                    "MonedaCodigo": "PEN",
                    "SucursalId": 3677,
                    "MargenGanancia": 0.000000,
                    "MargenPorcentaje": 0.000000,
                    "PrecioVenta": 0.000000,
                    "Sugerido": 0.000000,
                    "OtrosCargosPorcentaje": 0.000000,
                    "CantidadAplicable": 1.000000,
                    "FechaIngreso": "14/01/2023",
                    "FechaActualizacion": "14/01/2023",
                    "Estado": "1",
                    "ISCPorcentaje": 0.000000,
                    "ISCCalculado": 0.000000
                },
                .
                .
                .
            ]
        }

Respuesta json de productos múltiples

        [
            {
                "TipoProducto": "1",
                "ProductoCodigo": "Prod0904897",
                "ProductoCodigoSUNAT": "56112005",
                "ProductoDescripcion": "00 PRODUCTO EXONERADO 2.0",
                "ProductoCodigoCliente": "Prod0904897",
                "Observacion": "",
                "TipoAfectacionIGVCodigo": "20",
                "TipoSistemaISCCodigo": "00",
                "CodigoCategoria": 0,
                "Stock": 571.000000,
                "Cantidad": 1,
                "PrecioCodigo": "111551",
                "CantidadUnidadMedida": 1.000000,
                "UnidadMedidaCodigo": "NIU",
                "PrecioUnitario": 11.800000,
                "PrecioUnitarioSugerido": 0.00,
                "ICBPER": 0.000000000,
                "DescuentoIndicador": 0,
                "Descuento": 0,
                "DescuentoPorcentaje": 0,
                "DescuentoCargoCodigo": 0,
                "PercepcionCantidadUmbral": 0,
                "PercepcionMontoUmbral": 0.00,
                "PercepcionPorcentaje": 0.00,
                "Control": "0",
                "ValorUnitario": 0.00,
                "AplicaISC": false,
                "AplicaOtrosCargos": false,
                "AplicaICBPER": false,
                "Peso": 1.0,
                "Kit": false,
                "PrecioCompra": 0.983333,
                "ListaPrecios": [
                    {
                        "PrecioId": 111551,
                        "PrecioConfiguracion": 1,
                        "ProductoCodigo": "Prod0904897",
                        "CodigoUnidadMedida": "NIU",
                        "DescripcionUnidadMedida": "UNIDAD",
                        "CantidadUnidadMedida": 1.000000,
                        "MonedaCodigo": "PEN",
                        "SucursalId": 3677,
                        "MargenGanancia": 0.000000,
                        "MargenPorcentaje": 0.000000,
                        "PrecioVenta": 11.800000,
                        "Sugerido": 0.000000,
                        "OtrosCargosPorcentaje": 0.000000,
                        "CantidadAplicable": 0.000000,
                        "FechaIngreso": "30/12/2022",
                        "FechaActualizacion": "06/01/2023",
                        "Estado": "1",
                        "ISCPorcentaje": 0.000000,
                        "ISCCalculado": 0.000000
                    },
                    .
                    .
                    .
                ]
            },
            {
                "TipoProducto": "1",
                "ProductoCodigo": "Prod0904896",
                "ProductoCodigoSUNAT": "56112005",
                "ProductoDescripcion": "00 PRODUCTO GRAVADO",
                "ProductoCodigoCliente": "Prod0904896",
                "Observacion": "",
                "TipoAfectacionIGVCodigo": "10",
                "TipoSistemaISCCodigo": "00",
                "CodigoCategoria": 0,
                "Stock": 331.000000,
                "Cantidad": 1,
                "PrecioCodigo": "111539",
                "CantidadUnidadMedida": 1.000000,
                "UnidadMedidaCodigo": "NIU",
                "PrecioUnitario": 11.800000,
                "PrecioUnitarioSugerido": 0.00,
                "ICBPER": 0.000000000,
                "DescuentoIndicador": 0,
                "Descuento": 0,
                "DescuentoPorcentaje": 0,
                "DescuentoCargoCodigo": 0,
                "PercepcionCantidadUmbral": 0,
                "PercepcionMontoUmbral": 0.00,
                "PercepcionPorcentaje": 0.00,
                "Control": "0",
                "ValorUnitario": 0.00,
                "AplicaISC": false,
                "AplicaOtrosCargos": false,
                "AplicaICBPER": false,
                "Peso": 1.0,
                "Kit": true,
                "PrecioCompra": 5.000000,
                "ListaPrecios": [
                    {
                        "PrecioId": 111539,
                        "PrecioConfiguracion": 1,
                        "ProductoCodigo": "Prod0904896",
                        "CodigoUnidadMedida": "NIU",
                        "DescripcionUnidadMedida": "UNIDAD",
                        "CantidadUnidadMedida": 1.000000,
                        "MonedaCodigo": "PEN",
                        "SucursalId": 3677,
                        "MargenGanancia": 0.000000,
                        "MargenPorcentaje": 18.000000,
                        "PrecioVenta": 11.800000,
                        "Sugerido": 0.000000,
                        "OtrosCargosPorcentaje": 0.000000,
                        "CantidadAplicable": 0.000000,
                        "FechaIngreso": "30/12/2022",
                        "FechaActualizacion": "06/01/2023",
                        "Estado": "1",
                        "ISCPorcentaje": 0.000000,
                        "ISCCalculado": 0.000000
                    },
                    .
                    .
                    .
                ]
            }
        ]
        
        [
            {
                "TipoProducto": "1",
                "ProductoCodigo": "Prod0904897",
                "ProductoCodigoSUNAT": "56112005",
                "ProductoDescripcion": "00 PRODUCTO EXONERADO 2.0",
                "ProductoCodigoCliente": "Prod0904897",
                "Observacion": "",
                "TipoAfectacionIGVCodigo": "20",
                "TipoSistemaISCCodigo": "00",
                "CodigoCategoria": 0,
                "Stock": 571.000000,
                "Cantidad": 1,
                "PrecioCodigo": "111551",
                "CantidadUnidadMedida": 1.000000,
                "UnidadMedidaCodigo": "NIU",
                "PrecioUnitario": 11.800000,
                "PrecioUnitarioSugerido": 0.00,
                "ICBPER": 0.000000000,
                "DescuentoIndicador": 0,
                "Descuento": 0,
                "DescuentoPorcentaje": 0,
                "DescuentoCargoCodigo": 0,
                "PercepcionCantidadUmbral": 0,
                "PercepcionMontoUmbral": 0.00,
                "PercepcionPorcentaje": 0.00,
                "Control": "0",
                "ValorUnitario": 0.00,
                "AplicaISC": false,
                "AplicaOtrosCargos": false,
                "AplicaICBPER": false,
                "Peso": 1.0,
                "Kit": false,
                "PrecioCompra": 0.983333,
                "ListaPrecios": [
                    {
                        "PrecioId": 111551,
                        "PrecioConfiguracion": 1,
                        "ProductoCodigo": "Prod0904897",
                        "CodigoUnidadMedida": "NIU",
                        "DescripcionUnidadMedida": "UNIDAD",
                        "CantidadUnidadMedida": 1.000000,
                        "MonedaCodigo": "PEN",
                        "SucursalId": 3677,
                        "MargenGanancia": 0.000000,
                        "MargenPorcentaje": 0.000000,
                        "PrecioVenta": 11.800000,
                        "Sugerido": 0.000000,
                        "OtrosCargosPorcentaje": 0.000000,
                        "CantidadAplicable": 0.000000,
                        "FechaIngreso": "30/12/2022",
                        "FechaActualizacion": "06/01/2023",
                        "Estado": "1",
                        "ISCPorcentaje": 0.000000,
                        "ISCCalculado": 0.000000
                    },
                    .
                    .
                    .
                ]
            },
            {
                "TipoProducto": "1",
                "ProductoCodigo": "Prod0904896",
                "ProductoCodigoSUNAT": "56112005",
                "ProductoDescripcion": "00 PRODUCTO GRAVADO",
                "ProductoCodigoCliente": "Prod0904896",
                "Observacion": "",
                "TipoAfectacionIGVCodigo": "10",
                "TipoSistemaISCCodigo": "00",
                "CodigoCategoria": 0,
                "Stock": 331.000000,
                "Cantidad": 1,
                "PrecioCodigo": "111539",
                "CantidadUnidadMedida": 1.000000,
                "UnidadMedidaCodigo": "NIU",
                "PrecioUnitario": 11.800000,
                "PrecioUnitarioSugerido": 0.00,
                "ICBPER": 0.000000000,
                "DescuentoIndicador": 0,
                "Descuento": 0,
                "DescuentoPorcentaje": 0,
                "DescuentoCargoCodigo": 0,
                "PercepcionCantidadUmbral": 0,
                "PercepcionMontoUmbral": 0.00,
                "PercepcionPorcentaje": 0.00,
                "Control": "0",
                "ValorUnitario": 0.00,
                "AplicaISC": false,
                "AplicaOtrosCargos": false,
                "AplicaICBPER": false,
                "Peso": 1.0,
                "Kit": true,
                "PrecioCompra": 5.000000,
                "ListaPrecios": [
                    {
                        "PrecioId": 111539,
                        "PrecioConfiguracion": 1,
                        "ProductoCodigo": "Prod0904896",
                        "CodigoUnidadMedida": "NIU",
                        "DescripcionUnidadMedida": "UNIDAD",
                        "CantidadUnidadMedida": 1.000000,
                        "MonedaCodigo": "PEN",
                        "SucursalId": 3677,
                        "MargenGanancia": 0.000000,
                        "MargenPorcentaje": 18.000000,
                        "PrecioVenta": 11.800000,
                        "Sugerido": 0.000000,
                        "OtrosCargosPorcentaje": 0.000000,
                        "CantidadAplicable": 0.000000,
                        "FechaIngreso": "30/12/2022",
                        "FechaActualizacion": "06/01/2023",
                        "Estado": "1",
                        "ISCPorcentaje": 0.000000,
                        "ISCCalculado": 0.000000
                    },
                    .
                    .
                    .
                ]
            }
        ]

Descripción de los parámetros

campo	tipo	Valor Ejemplo	descripción
Codigo	String	Prod0904896	Código del producto, si se recupera con productos múltiples este campo deberá ir separado entre comas de inicio a final. ejemplo: ,Prod0904897,Prod0904896,
CodigoBarras	String	Prod00001	Código de barras del producto (campo opcional)
PrecioConfiguracionCodigo	Int	1	Id de precio configuración
MonedaCodigo	String	PEN	Código del tipo de moneda (PEN, USD)
Sucursal	Int	3677	Id de la sucursal

Consulta RUC web service SUNAT

La API padrón RUC es un servicio en línea que permite obtener información actualizada sobre contribuyentes en Perú a partir de su número de RUC. Este servicio facilita los datos como la razón social, estado y dirección del contribuyente. Para más detalles e implementación, contactarse con el area de ventas.

Integración

La ubicación de ambiente:

1. Access token vía resource owner credentials

2. Access token vía refresh token

Emisión de comprobantes

Formato para la emisión de un comprobante

Descripción de los elementos del objeto

Detalles

Objeto para la creación de un detalle

Descripción de los elementos del objeto

Movimientos

Objeto para la creación de movimientos

Descripción de los elementos del objeto

Respuesta de la petición

Cálculos aritméticos y catalogo de tablas

Factura

Ejemplos para la emision de una factura

Boleta

Ejemplos para la emision de una boleta

Anulación

Anulación de un comprobante

Objeto para la anulación de un comprobante

Descripción de los elementos del objeto

Anulacion mediante nota de crédito

Recuperar XML

Recuperar CDR

Reenviar

Ejemplos de petición para reenviar un comprobante

Respuesta de la petición

Descripción de los parametros

Recuperar

Ejemplos de petición para recuperar un comprobante

Respuesta de la petición

Buscar producto

Ejemplos de petición para buscar un producto

Respuesta de la petición

Descripción de los parámetros

Recuperar producto

Ejemplos de petición para recuperar un producto

Recuperar un producto

Recuperar productos múltiples

Respuesta de la petición

Respuesta json de un producto

Respuesta json de productos múltiples

Descripción de los parámetros

Consulta RUC web service SUNAT