# API facturación (v3) ### ¿Qué puedes hacer con nuestras APIS? * Integrar con tu software sin importar el lenguaje de programación * ARCHIVO PLANO: Usamos formatos JSON para recibir y entregarte la información de los comprobantes electrónicos. * Creamos XML firmado * Creamos PDF con tu logo y color * Obtener la respuesta (CDR) * Consultar el estado de cada comprobante * Descargar por API los archivos XML, PDF y CDR * Obtener el QR y código hash ### Los documentos que se encuentran contemplados son: 1. Factura 2. Boleta 3. Nota de Débito 4. Nota de Crédito 5. Comunicación de baja ### **Formato de comunicación** Cada solicitud generada, es una solicitud HTTP dirigida a un endpoint, dependiendo del tipo de acción, esta puede ser mediante un comando GET o POST. La URL para conectarse a crear comprobantes según el tipo de comprobante : * (Para crear documentos) * (Para anular un documento ) * (Para obtener el estado del documento) Recuerda que en cada pagina según tus requerimientos encontrarás las URL. ### Detalles técnicos Para poder usar nuestra API necesitas una RUTA, un TOKEN y un ARCHIVO PLANO (JSON ). RUTA: La puedes en de esta página. \ TOKEN: La puedes conseguir en la plataforma de factpro. \ ARCHIVO PLANO: Usamos formatos JSON # Introducción # Proceso de firma en las facturas {% embed url="" %} *** #### 🛡️ Firma Electrónica: Modelo PSE (Exclusivo Factpro) En Factpro trabajamos exclusivamente bajo la modalidad de Proveedor de Servicios Electrónicos (PSE). Esto significa que nosotros nos encargamos de la firma de tus comprobantes, simplificando tu gestión al máximo. ¿Por qué usamos este modelo en lugar de certificados (CDT o privados)? * Sin trámites de certificados: No necesitas solicitar el CDT gratuito ni comprar uno privado. * Cero configuración: No tienes que subir archivos técnicos, manejar claves de certificados ni preocuparte por fechas de vencimiento. * Firma Automática: Factpro firma y envía tus documentos directamente con nuestra propia infraestructura técnica. ¿Cómo se activa?: Proceso de Alta de Autorización de PSE 1. Ingresar al portal SOL: Iniciar sesión en el portal SUNAT Operaciones en Línea. 2. Utilizar el buscador: En la sección "¿Qué necesitas hacer?", escribir la palabra "altas" en el buscador. 3. Ubicar la opción correcta: En el resultado de la búsqueda, ubicar e ingresar a la opción "Altas/Bajas de PSE". 4. Agregar el servicio: En la vista de "COMUNICACION TERCERIZACIÓN CON PSE", hacer clic en el botón "Alta Servicio". 5. Configurar el RUC del proveedor: \* Buscar y agregar el RUC 20600337832 (correspondiente a VIDA SOFTWARE S.A.C.) y guardar. (RECUERDA el RUC mencionado solo sirve para FIRMAR el XML, todo proceso lo realiza dentro de factpro sin depender de terceros, ya que la firma esta alojado en nuestro servidores) * Regla de fecha: Recuerde que el inicio de autorización de envío es una fecha posterior al día actual, a partir de esa fecha podrás empezar a firmar tus facturas. 6. Confirmación: Finalmente, se agregará el registro en la lista de firma principal. > Nota: Al ser una solución optimizada y exclusiva para PSE, garantizamos que el proceso de firmado sea siempre fluido y sin interdependencias técnicas de tu lado. # Proceso de validación {% embed url="" %} *** #### 🏛️ Validación de Comprobantes: SUNAT y OSE En Factpro, la gestión de tus comprobantes electrónicos es flexible y se adapta al tamaño de tu empresa. **1. Nuestra ruta principal: Envío Directo a SUNAT** Por defecto, Factpro está configurado para realizar el envío directo a los servidores de la SUNAT. Esta es la modalidad estándar que permite: * Conexión inmediata con el ente regulador. * Obtención del CDR (Constancia de Recepción) de forma oficial. * Sin costos adicionales por validación de documentos. **2. Opción Avanzada: Validación vía OSE (Opcional)** Para empresas que requieren una capa adicional de validación o gestionan volúmenes muy altos, ofrecemos la opción de trabajar con un Operador de Servicios Electrónicos (OSE). * Alianza Estratégica: Trabajamos con aliados autorizados (como Nube) que actúan como una "SUNAT privada". * Validez Total: Todo documento procesado por la OSE (aceptado, rechazado o anulado) tiene plena validez fiscal. * Continuidad: Es una excelente alternativa para asegurar la validación de tus archivos XML en todo momento. > 💡 ¿Te interesa el modelo OSE? > > Esta modalidad es opcional y tiene un costo por documento validado. Si deseas activar este servicio o conocer más sobre los planes, por favor contacta a nuestro equipo comercial. # Arquitectura de Firmado y Comunicación Directa #### **Autonomía Técnica y Alta Disponibilidad de Factpro** A diferencia de otras soluciones que actúan como simples intermediarios, Factpro es el motor principal de toda su operación de facturación. Nuestra arquitectura está diseñada bajo un modelo de independencia total: * Infraestructura Soberana: No dependemos de proveedores externos o "pasarelas" de terceros para el firmado ni el envío. Toda la orquestación ocurre en nuestros propios servidores. * Certificación Propia: Utilizamos un certificado PSE alojado y gestionado directamente por nosotros. Esto garantiza que, ante caídas masivas de otros proveedores en el mercado, su empresa siga operando sin interrupciones. * Control End-to-End: Gestionamos el ciclo completo: desde el cálculo de impuestos y el firmado digital, hasta la comunicación directa con SUNAT y la obtención del CDR en tiempo real. *** #### Arquitectura de Firmado y Comunicación Directa La solución de Factpro integra la capacidad de un Proveedor de Servicios Electrónicos (PSE) con una infraestructura de servidores dedicados, optimizando el rendimiento mediante: 1. Firmado Digital Centralizado: El proceso de firma electrónica se realiza internamente mediante certificados digitales alojados en entornos controlados por nosotros, eliminando latencias y riesgos de conexión con terceros. 2. Orquestación Nativa: Realizamos el envío de los XML y la recepción de los CDR directamente con los servicios de SUNAT/OSE. 3. Resiliencia Operativa: Al evitar la dependencia de APIs externas para el procesamiento de documentos, garantizamos una mayor tasa de éxito en el envío, incluso en escenarios de intermitencia generalizada en el ecosistema de facturación peruano. # 🛡️ Plan de Contingencia y Resiliencia ante caídas de SUNAT Sabemos que la plataforma de SUNAT puede presentar intermitencias, especialmente en temporadas de alta demanda. Por ello, la arquitectura de Factpro está diseñada para que tu operación nunca se detenga. **1. Autonomía total en el Firmado** A diferencia de otras soluciones que dependen de servicios externos para firmar, Factpro genera y firma el XML en sus propios servidores. * El beneficio: Si SUNAT está caído, tu sistema puede seguir invocando nuestra API. Nosotros recibimos la data, creamos el archivo legal y lo firmamos al instante. **2. Cola de Reintentos Automática (Smart Retry)** Si al intentar enviar el documento detectamos que SUNAT no responde: * Persistencia: El documento firmado queda resguardado en nuestros servidores. * Reintentos programados: Nuestro sistema ejecuta un proceso de reenvío automático cada 5 minutos. * Sincronización: Una vez que SUNAT restablece su servicio, Factpro completa el envío y obtiene el CDR (Constancia de Recepción) sin que tú tengas que hacer nada manualmente. **3. Continuidad del Negocio (Business Continuity)** Para tu usuario final, el proceso es transparente: * Venta Ininterrumpida: Pueden seguir generando ventas y entregando el comprobante al cliente. * Validez Fiscal: Aunque el CDR llega apenas SUNAT se recupera, el documento ya fue creado y firmado con la fecha y hora correcta, cumpliendo con la normativa de contingencia. **4. Opción de Redundancia vía OSE** Si tu cliente opera en un entorno de misión crítica donde no puede esperar ni un minuto a que SUNAT despierte, ofrecemos la validación vía OSE: * Al ser una entidad privada autorizada, la OSE suele tener una disponibilidad mucho mayor que SUNAT. * Esta es una excelente alternativa de contingencia "Premium" que podemos activar tras una evaluación comercial. *** # Cómo empezar # 1 - Crear una cuenta Para poder crear empresas y obtener token, lo primero es crearse una cuenta en
# 2 - Crear empresa {% embed url="" %} # 3 - Crear sucursal {% embed url="" %} # 4 - Series {% embed url="" %} Para mejorar el proceso desde su software podrás crear series, previamente debes tener el siguiente concepto para evitar error: | Tipo de documento | Estructura de serie máximo 4 dígitos | | -------------------------------------- | ------------------------------------ | | FACTURA ELECTRÓNICA | F. . . | | BOLETA DE VENTA ELECTRÓNICA | B. . . | | NOTA DE CRÉDITO | FC . . ó BC . . | | NOTA DE DÉBITO | FD . . ó BD . . | | GUÍA DE REMISIÓN ELECTRÓNICA REMITENTE | T . . . | **Vía API** # 5 - Token {% embed url="" %} #### 1. CÓMO OBTENER EL TOKEN DE TU EMPRESA Contexto: Obtener el código de seguridad para integraciones. 1. Abre el menú principal en el lado izquierdo de tu pantalla. 2. Busca y haz clic en la opción Token. 3. Espera un momento a que aparezca el código en pantalla. 4. Haz clic en el botón de copiar (el icono de hojas de papel) para guardarlo en tu portapapeles. # Configuración de empresa # Crear empresas Ponemos a disposición dos formas para agregar nuevas empresas desde su sistema v**ía API o WEB**: **Vía API** Importante esta RUTA es solo para crear empresas desde su sistema sin necesidad de ingresar a la plataforma web, con este proceso estarás automatizando la gestión de una o más empresas desde su software. Cabe mencionar que para crear comprobantes electrónicos se envía a través de otra URL. Método **POST** **Token**: Para crear empresas deberás usar el token de usuario, no confundir con el token de empresa.\ Lo obtienes al crearte tu cuenta en **dashboard.factpro.la** URL POST **Body**
NameTypeDescription
identificacionstringRUC de la empresa
nombrestringRazon social
nombre_comercialstringSe puede ingresar un nombre comercial diferente a la razòn social
paisstringColocar el ID del paìs
**Body** {% code overflow="wrap" lineNumbers="true" fullWidth="false" %} ```json { "identificacion": "11107771255",//Ingresar el RUC "nombre": "REPRESENTACIONE 23S",//Obligatorio Razòn social "nombre_comercial": "", //opcional "pais": "2" // 2 = Perù } ``` {% endcode %} **Response** {% code lineNumbers="true" fullWidth="false" %} ```json { "exito": true, "mensaje": "Se ha Registrado satisfactoriamente", "token": "a3ggeFH3334f3534K" } ``` {% endcode %} **Vía WEB** # Pasos para activar el CDR Automático Con estos pasos podrás obtener el estado aceptado de manera inmediata 1. En el menú lateral izquierdo, ingresa a Integracion. 2. En la lista, ubica el tipo FIRMA y haz clic en el boton (configurar) ubicado en la primera tarjeta. 3. En el modal emergente, activa el interruptor Obtener CDR automático en documentos. 4. Haz clic en Guardar. #### Funcionamiento y Ventajas del Proceso Con la opción ACTIVADA (Aceptación Inmediata) * Proceso: Creación de XML $$ $\to$ $$ Firma en servidor de Factpro $$ $\to$ $$ Envío inmediato a SUNAT $$ $\to$ $$ Recepción del CDR. * Ventaja: Obtienes el estado de "Aceptado" en cuestión de segundos. * Consideración: El sistema seguirá operando, pero la velocidad de generación dependerá de la latencia y disponibilidad del servidor de SUNAT, lo que puede generar ligeras demoras. Con la opción DESACTIVADA (Alta Velocidad y Tolerancia a Fallos) * Proceso: Generación inmediata del comprobante en el sistema. El envío a SUNAT se delega a una tarea en segundo plano que se ejecuta cada 5 minutos. * Ventaja: Si los servicios de SUNAT están fallando o lentos, puedes seguir generando documentos de forma rápida y sin bloqueos para el usuario. # Actualizar empresa **Método ****PUT** **Tipo:** Bearer token **Token:** token de la empresa **URL:** {id\_empresa} **Body** {% code overflow="wrap" lineNumbers="true" fullWidth="false" %} ```json { "nombre": "REPRESENTACIONE 23S",//Obligatorio Razòn social "nombre_comercial": "", //opcional } ``` {% endcode %} **Response** {% code lineNumbers="true" fullWidth="false" %} ```json { "exito": true, "mensaje": "Se ha actualizado satisfactoriamente", } ``` {% endcode %} # Cambiar color por API Método **PUT** **Tipo:** Bearer token **Token:** token de la empresa **URL: ** **Body** ```json { "color_pdf": "#000000" } ``` # Cambiar logo por API Método **PUT** **Tipo:** Bearer token **Token:** token de la empresa **URL: ** **Body** ```json { "imagen": "data:image/png;base64,iVBORw0" } ``` # Crear sucursal **Crear establecimiento por API** Método **POST** **Tipo:** Bearer token **Token:** token de la empresa **URL:** **Body** ```json { "nombre": "Sede principal", // opcional "codigo_anexo": "0000", // obligatorio "direccion": "Av central 192", // obligatorio "ubigeo_id": "010104", // obligatorio, descargar excel de ubigeo PERU https://datosabiertos.gob.pe/dataset/ubigeos-c%C3%B3digos-de-ubicaci%C3%B3n-geogr%C3%A1fica-instituto-nacional-de-estad%C3%ADstica-e-inform%C3%A1tica-inei "correo_electronico": "3@gmail.com" // opcional } ``` # Editar sucursal **Método ****PUT** **Tipo:** Bearer token **Token:** token de la empresa **URL:** {id\_sucursal} **Body** ```json { "nombre": "Sede 2", // opcional "codigo_anexo": "0000", //codigo anexo "direccion": "Av central 192", // obligatorio "ubigeo_id": "010104", // obligatorio "correo_electronico": "3@gmail.com" // opcional } ``` # Listar sucursal **Listar sucursales por API** **Método ****GET** **Tipo:** Bearer token **Token:** token de la empresa **RL:** **Response** {% tabs %} {% tab title="true" %} ```json { "total": 8, "limit": 10, "offset": 0, "total_pages": 1, "current_page": 1, "docs": [ { "nombre": "343443434", "codigo_anexo": "3434", "direccion": "434erer", "correo_electronico": "", "ubigeo_id": "010102", "telefono": null, "fecha_de_creacion": "2025-07-17T23:45:23.138360Z", "id": 5 }, { "nombre": "fffffff", "codigo_anexo": "3334", "direccion": "ffff", "correo_electronico": "", "ubigeo_id": "010104", "telefono": null, "fecha_de_creacion": "2025-07-17T23:45:38.264771Z", "id": 6 }, { "nombre": "ffff445455", "codigo_anexo": "4545", "direccion": "tttttt", "correo_electronico": "", "ubigeo_id": "010101", "telefono": null, "fecha_de_creacion": "2025-07-17T23:45:49.360309Z", "id": 7 }, { "nombre": "hhhhhhh", "codigo_anexo": "5555", "direccion": "gggg", "correo_electronico": "", "ubigeo_id": "010106", "telefono": null, "fecha_de_creacion": "2025-07-17T23:46:01.459425Z", "id": 8 }, { "nombre": "gggggggg", "codigo_anexo": "8878", "direccion": "gggggt", "correo_electronico": "", "ubigeo_id": "010104", "telefono": null, "fecha_de_creacion": "2025-07-17T23:46:28.334534Z", "id": 9 }, { "nombre": "Oficina Principal", "codigo_anexo": "0000", "direccion": "string", "correo_electronico": "user@example.com", "ubigeo_id": "010104", "telefono": "3434", "fecha_de_creacion": "2025-07-05T19:45:04.723495Z", "id": 1 }, { "nombre": "Sede test", "codigo_anexo": "0003", "direccion": "r3333", "correo_electronico": "3@gmail.com", "ubigeo_id": "010103", "telefono": "", "fecha_de_creacion": "2025-08-01T16:57:28.438026Z", "id": 10 }, { "nombre": "Sede nuevo", "codigo_anexo": "0015", "direccion": "r3333", "correo_electronico": "3@gmail.com", "ubigeo_id": "134343", "telefono": "", "fecha_de_creacion": "2025-08-04T16:44:22.207822Z", "id": 13 } ] } ``` {% endtab %} {% endtabs %} # Eliminar sucursal **Listar sucursales por API** **Método ****PUT** **Tipo:** Bearer token **Token:** token de la empresa **RL:** {id\_sucursal} **Response** {% tabs %} {% tab title="true" %} ```json { "message": "Sucursal eliminado." } ``` {% endtab %} {% endtabs %} # Nueva serie Para mejorar el proceso desde su software podrás crear series, previamente debes tener el siguiente concepto para evitar error: | Tipo de documento | Estructura de serie máximo 4 dígitos | | -------------------------------------- | ------------------------------------ | | FACTURA ELECTRÓNICA | F. . . | | BOLETA DE VENTA ELECTRÓNICA | B. . . | | NOTA DE CRÉDITO | FC . . ó BC . . | | NOTA DE DÉBITO | FD . . ó BD . . | | GUÍA DE REMISIÓN ELECTRÓNICA REMITENTE | T . . . | **Vía API** Método **POST** **Tipo:** Bearer token **Token:** token de la empresa **URL:** **Body** ```json { "tipo_documento": 7, //catálogo https://docs.factpro.la/catalogos-sunat/catalogo-08-tipos-de-documentos "serie": "FFF1", "numero_a_comenzar": 1, "sucursal": "1" // ID de sucursal } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "tipo_documento": 7, "serie": "FFF2", "numero_a_comenzar": 1, "sucursal": 13, "id": 12 } ``` {% endtab %} {% endtabs %} # Listar series **Vía API** Método **GET** **Tipo:** Bearer token **Token:** token de la empresa **URL:** {id\_sucursal} **Response** {% tabs %} {% tab title="true" %} ```json [ { "tipo_documento": 7, "serie": "FFF1", "numero_a_comenzar": 1, "sucursal": 13, "id": 11 } ] ``` {% endtab %} {% endtabs %} # Eliminar serie **Vía API** **Método ****PUT** **Tipo:** Bearer token **Token:** token de la empresa **URL:** {id\_serie} **Response** {% tabs %} {% tab title="true" %} ```json { "message": "Serie eliminado." } ``` {% endtab %} {% endtabs %} # Estructura para generar facturas **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body**
ATRIBUTOVALORREQUISITOLONGUITUD
serie
Debe ingresar "F" para FACTURAS y con "B" para BOLETAS DE VENTA. Para su generación debe tener en cuenta que el comprobante debe estar aceptado.Obligatorio4 exacto
numero
Número correlativo del documentoObligatorio1 hasta 8
fecha_de_emision
Opcional
Debe ser la fecha actual. Ejemplo: 2024-05-14		Opcional10 exacto

moneda

Opcional , por defecto siempre sera en MONEDA "PEN"
PEN = SOLES

USD= DÓLARES

Opcional3 exacto
tipo_operacion

En todos los casos se utiliza por defecto: 1

1= Venta interna

2= Exportación

3= Operación Sujeta a Detracción
4= Operación Sujeta a Detracción- Servicios de Transporte Carga
5= Ventas no domiciliados que no califican como exportación

Obligatorio4 exacto
enviar_automaticamente_al_cliente
Dirección de email
false = No se enviara
true = Se enviará automáticamente
Opcional
DATOS DEL CLIENTE
cliente_tipo_documento
1=Otros
2=DNI
3=CE
4=RUC
5=Pasaporte		Obligatorio1 exacto
cliente_numero_documento
Ejemplo: RUC del CLIENTE, número de DNI, Etc.Obligatorio1 hasta 15
cliente_denomiacion
Razón o nombre completo del CLIENTE.Obligatorio1 hasta 100
codigo_pais
Colocar el país del CLIENTE, por ejemplo Perú = PEOpcional2 exacto
ubigeo
Debe ingresar número por código de Ubigeo , por ejemplo 150101Opcional2 exacto
cliente_direccion
Dirección completa (OPCIONAL en caso de ser una BOLETA DE VENTA o NOTA ASOCIADA).Condicional1 hasta 100
cliente_email
Correo referencialOpcional
cliente_telefono
Teléfono referencialOpcional
ITEMS
unidad

Enviar las unidades de medida, por ejemplo para Unidad es = NIU

NIU = PRODUCTO

ZZ = SERVICIO

Obligatorio2 hasta 5
codigo
Opcional, código interno del producto por ejemplo P0121Opcional1 hasta 250
descripcion
Nombre del productoObligatorio1 hasta 250
cantidad
Ejemplo: 10.00Obligatorio1 hasta 12 enteros, hasta con 10 decimales
precio
Ejemplo: 100Obligatorio1 hasta 12 enteros, hasta con 10 decimales
incluye_tax
Si el precio que utilizas en tu app no incluye impuesto debes de colocar: false

Si el precio que envias ya incluye el impuesto, puedes enviarnos como : true o no es necesario enviar esta variable		Opcional4 hasta 5
tipo_tax
1=Gravado - Operación Onerosa
20=Exonerado - Operación Onerosa
21=Exonerado – Transferencia Gratuita
30=Inafecto - Operación Onerosa
40=Exportación de bienes o servicios		Obligatorio2 exacto

descuento
Ejemplo: 5Opcional1 hasta 12 enteros, hasta con 10 decimales
CONDICIÓN DE PAGO
tipo_de_condicion
0= Contado y 1 = CréditoCondicional1 exacto
fecha_de_pago
Solo aplica si es a crédito
tendrán un formato: 2024-01-03		Condicional10 exacto
monto
Solo aplica si es a crédito
debe ir el monto de la cuota, ejemplo 50.00		Condicional1 hasta 12 enteros con 2 decimales
OTROS CAMPOS
formato_pdf
Puedes elegir entre a4 o ticket para mostrar automáticamente el formato del PDFObligatorio
numero_orden
Texto de 0 hasta 20 caracteres.Opcional
observaciones
Texto de 0 hasta 1000 caracteres.Opcional
**Body** ```json { "serie": "F100", "numero": "#", "tipo_operacion": "1", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20605577241", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "cliente_direccion": "Av.", "cliente_email": "laverioa@gmail.com", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "PC 3434", "cantidad": 1, "precio": 100, "tipo_tax": "1", "descuento": 0.00 } ], "condicion_de_pago": [ { "tipo_de_condicion": "0", "forma_de_pago":"0", "monto": 0 } ], "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="200" %} ```json { "success": true, "data": { "number": "F001-5", "filename": "20415963255-01-F001-5", "external_id": "103c8710-6c6e-4b7b-8d7b-c59f642c7a71", "number_to_letter": "Ciento dieciocho con 00/100 ", "hash": "gLOlpznxBvvhT/BUUugMYDhQo84=", "qr": "iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAEgklEQVR4nO2d3XYbMQgG4568/yund45bqwQBWneOZy7t1U/yHZAWIXz7+vr6EDK/Xj0B6aKEeJQQjxLiUUI8SohHCfEoIR4lxKOEeJQQjxLi+Uw+d7vd+oM9htTvHd4/fBzi+=" }, "links": { "xml": "https://factpro.pe/downloads/document/xml/103c8710-6c6e-4b7b-8d7b-c59f642c7a71", "pdf": "https://factpro.pe/downloads/document/pdf/103c8710-6c6e-4b7b-8d7b-c59f642c7a71", "cdr": "https://factpro.pe/downloads/document/cdr/103c8710-6c6e-4b7b-8d7b-c59f642c7a71" }, "response": { "code": "0", "description": "La Factura numero F001-5, ha sido aceptada", "notes": [] } } ``` {% endtab %} {% endtabs %} [^1]: # Factura simple Se puede utilizar para crear ventas como factura o boleta electrónica **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F100", "numero": "#", //"fecha_de_emision": "2025-12-01",// opcional //"moneda": "USD", //opcional "tipo_operacion": "1", //https://docs.factpro.la/catalogos-sunat/catalogo-51-codigo-de-tipo-de-operacion "enviar_automaticamente_al_cliente": false, "cliente": { "cliente_tipo_documento": "4", //catálogo: https://docs.factpro.la/catalogos-sunat/cata "cliente_numero_documento": "20605577241", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", //catálogo: https://docs.factpro.la/unidades-de-medida-universal //Obligatorio "codigo": "", "descripcion": "PC 3434", //Obligatorio "cantidad": 1, //Obligatorio "precio": 100, //Obligatorio, "incluye_tax": true, //opcional "tipo_tax": "1", //catálogo: https://docs.factpro.la/catalogos-sunat/catalogo-07-impuestos //Obligatorio "descuento": 0.00 //opcional } ], "condicion_de_pago": [ { "tipo_de_condicion": "0", //Al contado "forma_de_pago":"0", "monto": 0 } ], "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Factura al crédito Se puede utilizar para crear ventas con condición al crédito como factura o boleta electrónica **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F100", "tipo_operacion":"1", "numero": "#", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20605577246", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "test crEed", "cantidad": 1, "precio": 100, "tipo_tax": "1", "descuento": 0.00 } ], "condicion_de_pago": [ {//cuota1 "tipo_de_condicion": "1", // 1 = Crédito "forma_de_pago":"", //Para Perú puede ir vacio "fecha": "19-08-2025", //obligatorio para Perú cuando es tipo 1 "monto": 50.00 ///obligatorio para Perú cuando es tipo 1 }, {//cuota2 "tipo_de_condicion": "1", 1 = Crédito "forma_de_pago":"", //Para Perú puede ir vacio "fecha": "19-09-2025", //obligatorio para Perú cuando es tipo 1 "monto": 50.00 ///obligatorio para Perú cuando es tipo 1 } ], "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Factura con otros cargos Se puede utilizar para crear ventas como factura o boleta electrónica **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "FFF1", "numero": "#", //"moneda": "USD", // X "tipo_operacion": "1", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20609753120", "cliente_denominacion": "FACTPRO LATAM S.A.C.", "cliente_direccion": "Av.", "cliente_email": "anghelo@factpro.la", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "PC 3434", "cantidad": 1, "precio": 100, "tipo_tax": "1", "descuento": 0.00 } ], "condicion_de_pago": [ { "tipo_de_condicion": "0", "forma_de_pago":"0", //"fecha": "2025-05-15", "monto": 0 } ], "totales": { "monto_otros_cargos": 5.00 //Añadir el monto adicional del cual sumará al total de la venta }, "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Factura + bolsas de plástico (ICBP) En este ejemplo se realizará una venta con anticipos **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "FFF1", "numero": "#", //"moneda": "USD", // X "tipo_operacion": "1", "enviar_automaticamente_al_cliente": false, "numero_orden":"TTTT", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20609753120", "cliente_denominacion": "FACTPRO LATAM S.A.C.", "cliente_direccion": "Av.", "cliente_email": "anghelo@factpro.la", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "PC 3434", "cantidad": 2, "precio": 100, "tipo_tax": "1", "descuento": 0.00, "bolsa_tax": "102" //Añadir el código 102, con ello se estaría añadiendo adicional s/0.50 } ], "condicion_de_pago": [ { "tipo_de_condicion": "0", "forma_de_pago":"0", //"fecha": "2025-05-15", "monto": 0 } ], "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Factura con descuentos En este ejemplo se aplica descuento por item y global **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F100", "tipo_operacion":"1", "numero": "#", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20605577242", "cliente_denominacion": "CORPORACION VEL S.A.C.", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "tablet", "cantidad": 1, "precio": 100, "tipo_tax": "1", "descuento": 10.00 } ], "condicion_de_pago": [ { "tipo_de_condicion": "0", "forma_de_pago":"0", "monto": 0 } ], "totales": { "monto_descuento_global": 5.00 }, "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Factura exonerado En este ejemplo aplicaremos a un item con tipo Exonerado - Operación Onerosa **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F100", "tipo_operacion":"1", "numero": "#", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20605577246", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "Test", "cantidad": 1, "precio": 100, "tipo_tax": "20", // Exonerado - Operación Onerosa "descuento": 0.00 } ], "condicion_de_pago": [ { "tipo_de_condicion": "0", // 0 = Al contado "forma_de_pago":"0", "fecha": "", "monto": 0.00 } ], "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Factura inafecta En este ejemplo aplicaremos a un item con tipo Inafecta- Operación Onerosa **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F100", "tipo_operacion":"1", "numero": "#", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20605577246", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "Test", "cantidad": 1, "precio": 100, "tipo_tax": "30", // Inafecta- Operación Onerosa "descuento": 0.00 } ], "condicion_de_pago": [ { "tipo_de_condicion": "0", // 0 = Al contado "forma_de_pago":"0", "fecha": "", "monto": 0.00 } ], "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Factura gratuita En este ejemplo aplicaremos a un item con tipo Exonerado – Transferencia Gratuita **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F100", "tipo_operacion":"1", "numero": "#", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20605577246", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "TEST", "cantidad": 1, "precio": 100, "tipo_tax": 21, // Exonerado – Transferencia Gratuita "descuento": 0.00 } ], "condicion_de_pago": [ { "tipo_de_condicion": "0",// 0 = Al contado "forma_de_pago":"0", "fecha": "", "monto": 0 } ], "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Factura exportación En este ejemplo aplicaremos a un item con tipo exportación **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F100", "tipo_operacion":"2", "numero": "#", "cliente": { "cliente_tipo_documento": "1", //Cliente solo tipo 1 para tipo de operacion 2 "cliente_numero_documento": "70500443", "cliente_denominacion": "Empresa extranjera ejemplo", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "TEST", "cantidad": 1, "precio": 100, "tipo_tax": "40", // Exportación "descuento": 0.00 } ], "condicion_de_pago": [ { "tipo_de_condicion": "0", // 0 = Al contado "forma_de_pago":"0", "fecha": "", "monto": 0.00 } ], "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Factura detracción En este ejemplo se realizará una venta con detracción al contado **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F100", "tipo_operacion":"3", "numero": "#", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20605577246", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "test detrraccion", "cantidad": 1, "precio": 1000, "tipo_tax": "1", "descuento": 0.00 } ], "condicion_de_pago": [ { "tipo_de_condicion": "0", // 0 = Al contado "forma_de_pago":"", "fecha": "", "monto": 0.00 } ], "detraccion":{ "codigo": "50", //Catálogo 54 "forma_de_pago": "1" }, "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Factura detracción - transporte En este ejemplo se realizará una venta con detracción tipo transporte al contado **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F100", "tipo_operacion":"4",//Operación Sujeta a Detracción- Servicios de Transporte Carga "numero": "#", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20605577246", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "tesrrtt", "cantidad": 1, "precio": 700, "tipo_tax": "1", "descuento": 0.00 } ], "condicion_de_pago": [ { "tipo_de_condicion": "0", // 0 = Al contado "forma_de_pago":"", "fecha": "", "monto": 0.00 } ], "detraccion":{ "codigo": "73", //Catálogo 54 "forma_de_pago": "1" }, "datos_transporte_carga": { "ubigeo_origen": "150101", "direccion_origen":"av. 11111", "ubigeo_destino": "150102", "direccion_destino":"av. 2222", "valor_referencial_servicio_de_transporte":"1", "valor_referencial_carga_efectiva":"1", "valor_referencial_carga_util":"1", "detalle_del_viaje":"dato referencial" }, "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Factura retención En este ejemplo se realizará una venta con retención **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F100", "tipo_operacion":"1", "numero": "#", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20605577246", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "test", "cantidad": 1, "precio": 3600, "tipo_tax": "1", "descuento": 0.00 } ], "condicion_de_pago": [ { "tipo_de_condicion": "0", "forma_de_pago":"", "fecha": "", "monto": 0.00 } ], "retencion":{ "codigo": "100" //catálogo :https://docs.factpro.la/catalogos-sunat/catalogo-23-codigo-de-regimen-de-retenciones }, "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Factura anticipos En este ejemplo se realizará una venta con anticipos **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F100", "tipo_operacion":"1", "numero": "#", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20605577246", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "test anticipos", "cantidad": 1, "precio": 100, "tipo_tax": "1", "descuento": 0.00 } ], "condicion_de_pago": [ { "tipo_de_condicion": "0", // 0 = Al contado "forma_de_pago":"", "fecha": "", "monto": 0.00 } ], "anticipos": [ //Se deberá de colocar los datos de la factura relacionada { "tipo_documento":"7", "serie": "F100", "numero": 10, "total": 50 } ], "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Estructura para generar nota de crédito **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body**
ATRIBUTOVALORREQUISITOLONGUITUD
serie
Debe ingresar "F" para FACTURAS y con "B" para BOLETAS DE VENTA. Para su generación debe tener en cuenta que el comprobante debe estar aceptado.Obligatorio4 exacto
numero
Número correlativo del documentoObligatorio1 hasta 8
tipo_operacion

En todos los casos se utiliza por defecto: 1

1= Venta interna

2= Exportación

3= Operación Sujeta a Detracción
4= Operación Sujeta a Detracción- Servicios de Transporte Carga
5= Ventas no domiciliados que no califican como exportación

Obligatorio4 exacto
tipo_nota
1 = Anulación de la operación
2=Anulación por error en el RUC
3=Corrección por error en la descripción
4=Descuento global
5=Descuento por ítem
6=Devolución total
7=Devolución por ítem
8=Bonificación
9=Disminución en el valor
10=Otros Conceptos
11=Ajustes de operaciones de exportación
12=Ajustes afectos al IVAP
13=Ajustes – montos y/o fechas de pago		Obligatorio
motivo_nota
Añadir una descripción por el cual se realiza la notaObligatorio
enviar_automaticamente_al_cliente
Dirección de email
false = No se enviara
true = Se enviará automáticamente
Opcional
DATOS DEL CLIENTE
cliente_tipo_documento
1=Otros
2=DNI
3=CE
4=RUC
5=Pasaporte		Obligatorio1 exacto
cliente_numero_documento
Ejemplo: RUC del CLIENTE, número de DNI, Etc.Obligatorio1 hasta 15
cliente_denomiacion
Razón o nombre completo del CLIENTE.Obligatorio1 hasta 100
codigo_pais
Colocar el país del CLIENTE, por ejemplo Perú = PEOpcional2 exacto
ubigeo
Debe ingresar número por código de Ubigeo , por ejemplo 150101Opcional2 exacto
cliente_direccion
Dirección completa (OPCIONAL en caso de ser una BOLETA DE VENTA o NOTA ASOCIADA).Condicional1 hasta 100
cliente_email
Correo referencialOpcional
cliente_telefono
Teléfono referencialOpcional
ITEMS
unidad

Enviar las unidades de medida, por ejemplo para Unidad es = NIU

NIU = PRODUCTO

ZZ = SERVICIO

Obligatorio2 hasta 5
codigo
Opcional, código interno del producto por ejemplo P0121Opcional1 hasta 250
descripcion
Nombre del productoObligatorio1 hasta 250
cantidad
Ejemplo: 10.00Obligatorio1 hasta 12 enteros, hasta con 10 decimales
precio_unitario
Con IGV. Ejemplo: 59Obligatorio1 hasta 12 enteros, hasta con 10 decimales
tipo_tax
1=Gravado - Operación Onerosa
2=Exonerado - Operación Onerosa
3=Exonerado – Transferencia Gratuita
4=Inafecto - Operación Onerosa
5=Exportación de bienes o servicios		Obligatorio2 exacto
CONDICIÓN DE PAGOSolo aplica si es tipo de nota (13=Ajustes – montos y/o fechas de pago)
tipo_de_condicion
1 = CréditoCondicional1 exacto
fecha_de_pago
Solo aplica si es a crédito
tendrán un formato: 01-12-2025		Condicional10 exacto
monto
Solo aplica si es a crédito
debe ir el monto de la cuota, ejemplo 50.00		Condicional1 hasta 12 enteros con 2 decimales
OTROS CAMPOS
formato_pdf
Puedes elegir entre a4 o ticket para mostrar automáticamente el formato del PDFObligatorio
numero_orden
Texto de 0 hasta 1000 caracteres.Opcional
codigo
Texto de 0 hasta 1000 caracteres.Opcional
observaciones
Texto de 0 hasta 1000 caracteres.Opcional
**Body** ```json { "serie": "FC01", "tipo_operacion":"1", "numero": "#", "tipo_nota": "1",// catálogo: https://docs.factpro.la/catalogos-sunat/catalogo-10-codigos-de-tipo-de-nota-de-debito "motivo_nota": "Error al emitir comprobante", "documento_afectado": { "tipo_documento": "7", //catálogo: https://docs.factpro.la/catalogos-sunat/catalogo-08-tipos-de-documentos "serie": "F100", "numero": "10" }, "cliente": { "cliente_tipo_documento": "1", //catálogo: https://docs.factpro.la/catalogos-sunat/catalogo-06-tipo-de-documento-de-identidad "cliente_numero_documento": "20605577246", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", //catálogo: https://docs.factpro.la/unidades-de-medida-universal "codigo": "", "descripcion": "test note credit", "cantidad": 1, "precio": 100, "tipo_tax": "1" //catálogo: https://docs.factpro.la/catalogos-sunat/catalogo-07-impuestos } ], "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="200" %} ```json { "success": true, "data": { "number": "F001-5", "filename": "20415963255-01-F001-5", "external_id": "103c8710-6c6e-4b7b-8d7b-c59f642c7a71", "number_to_letter": "Ciento dieciocho con 00/100 ", "hash": "gLOlpznxBvvhT/BUUugMYDhQo84=", "qr": "iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAEgklEQVR4nO2d3XYbMQgG4568/yund45bqwQBWneOZy7t1U/yHZAWIXz7+vr6EDK/Xj0B6aKEeJQQjxLiUUI8SohHCfEoIR4lxKOEeJQQjxLi+Uw+d7vd+oM9htTvHd4/fBzi+=" }, "links": { "xml": "https://factpro.pe/downloads/document/xml/103c8710-6c6e-4b7b-8d7b-c59f642c7a71", "pdf": "https://factpro.pe/downloads/document/pdf/103c8710-6c6e-4b7b-8d7b-c59f642c7a71", "cdr": "https://factpro.pe/downloads/document/cdr/103c8710-6c6e-4b7b-8d7b-c59f642c7a71" }, "response": { "code": "0", "description": "La Factura numero F001-5, ha sido aceptada", "notes": [] } } ``` {% endtab %} {% endtabs %} # Nota de crédito En este ejemplo se aplicará una nota de crédito a una venta. **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "FC01", "tipo_operacion":"1", "numero": "#", "tipo_nota": "1",// utilizar esta estructura para tipo del 1 al 12 "motivo_nota": "Error al emitir comprobante", "documento_afectado": { "tipo_documento": "7", "serie": "F100", "numero": 10 }, "cliente": { "cliente_tipo_documento": "1", "cliente_numero_documento": "20605577246", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "test note credit", "cantidad": 1, "precio": 100, "tipo_tax": "1" } ], "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Estructura para generar nota de débito **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body**
ATRIBUTOVALORREQUISITOLONGUITUD
serie
Debe ingresar "F" para FACTURAS y con "B" para BOLETAS DE VENTA. Para su generación debe tener en cuenta que el comprobante debe estar aceptado.Obligatorio4 exacto
numero
Número correlativo del documentoObligatorio1 hasta 8
tipo_operacion

En todos los casos se utiliza por defecto: 1

1= Venta interna

2= Exportación

3= Operación Sujeta a Detracción
4= Operación Sujeta a Detracción- Servicios de Transporte Carga
5= Ventas no domiciliados que no califican como exportación

Obligatorio4 exacto
tipo_nota
14=Intereses por mora
15=Aumento en el valor
16=Penalidades/ otros conceptos
17=Ajustes de operaciones de exportación
18=Ajustes afectos al IVAP		Obligatorio
motivo_nota
Añadir una descripción por el cual se realiza la notaObligatorio
enviar_automaticamente_al_cliente
Dirección de email
false = No se enviara
true = Se enviará automáticamente
Opcional
DATOS DEL CLIENTE
cliente_tipo_documento
1=Otros
2=DNI
3=CE
4=RUC
5=Pasaporte
6=Registro civil
7=Cédula de ciudadanía		Obligatorio1 exacto
cliente_numero_documento
Ejemplo: RUC del CLIENTE, número de DNI, Etc.Obligatorio1 hasta 15
cliente_denomiacion
Razón o nombre completo del CLIENTE.Obligatorio1 hasta 100
codigo_pais
Colocar el país del CLIENTE, por ejemplo Perú = PEOpcional2 exacto
ubigeo
Debe ingresar número por código de Ubigeo , por ejemplo 150101Opcional2 exacto
cliente_direccion
Dirección completa (OPCIONAL en caso de ser una BOLETA DE VENTA o NOTA ASOCIADA).Condicional1 hasta 100
cliente_email
Correo referencialOpcional
cliente_telefono
Teléfono referencialOpcional
ITEMS
unidad

Enviar las unidades de medida, por ejemplo para Unidad es = NIU

NIU = PRODUCTO

ZZ = SERVICIO

Obligatorio2 hasta 5
codigo
Opcional, código interno del producto por ejemplo P0121Opcional1 hasta 250
descripcion
Nombre del productoObligatorio1 hasta 250
cantidad
Ejemplo: 10.00Obligatorio1 hasta 12 enteros, hasta con 10 decimales
precio_unitario
Con IGV. Ejemplo: 59Obligatorio1 hasta 12 enteros, hasta con 10 decimales
tipo_tax
1=Gravado - Operación Onerosa
2=Exonerado - Operación Onerosa
3=Exonerado – Transferencia Gratuita
4=Inafecto - Operación Onerosa
5=Exportación de bienes o servicios		Obligatorio2 exacto
CONDICIÓN DE PAGO
tipo_de_condicion
0= Contado y 1 = CréditoCondicional1 exacto
fecha_de_pago
Solo aplica si es a crédito
tendrán un formato: 2024-01-03		Condicional10 exacto
monto
Solo aplica si es a crédito
debe ir el monto de la cuota, ejemplo 50.00		Condicional1 hasta 12 enteros con 2 decimales
OTROS CAMPOS
formato_pdf
Puedes elegir entre a4 o ticket para mostrar automáticamente el formato del PDFObligatorio
numero_orden
Texto de 0 hasta 1000 caracteres.Opcional
codigo
Texto de 0 hasta 1000 caracteres.Opcional
observaciones
Texto de 0 hasta 1000 caracteres.Opcional
**Body** ```json { "serie": "FB01", "tipo_operacion":"1", "numero": "#", "tipo_nota": "14", "motivo_nota": "MORA", "documento_afectado": { "tipo_documento": "7", "serie": "F100", "numero": "10" }, "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20605577246", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "test", "cantidad": 1, "precio": 100, "tipo_tax": "1" } ], "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="200" %} ```json { "success": true, "data": { "number": "F001-5", "filename": "20415963255-01-F001-5", "external_id": "103c8710-6c6e-4b7b-8d7b-c59f642c7a71", "number_to_letter": "Ciento dieciocho con 00/100 ", "hash": "gLOlpznxBvvhT/BUUugMYDhQo84=", "qr": "iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAEgklEQVR4nO2d3XYbMQgG4568/yund45bqwQBWneOZy7t1U/yHZAWIXz7+vr6EDK/Xj0B6aKEeJQQjxLiUUI8SohHCfEoIR4lxKOEeJQQjxLi+Uw+d7vd+oM9htTvHd4/fBzi+=" }, "links": { "xml": "https://factpro.pe/downloads/document/xml/103c8710-6c6e-4b7b-8d7b-c59f642c7a71", "pdf": "https://factpro.pe/downloads/document/pdf/103c8710-6c6e-4b7b-8d7b-c59f642c7a71", "cdr": "https://factpro.pe/downloads/document/cdr/103c8710-6c6e-4b7b-8d7b-c59f642c7a71" }, "response": { "code": "0", "description": "La Factura numero F001-5, ha sido aceptada", "notes": [] } } ``` {% endtab %} {% endtabs %} # Nota de débito En este ejemplo se aplicará una nota de crédito a una venta. **POST**`https://api.factpro.la/api/v3/documentos` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "FB01", "tipo_operacion":"1", "numero": "#", "tipo_nota": "14", "motivo_nota": "MORA", "documento_afectado": { "tipo_documento": "7", "serie": "F100", "numero": 10 }, "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20605577246", "cliente_denominacion": "CORPORACION VEL PERU S.A.C.", "codigo_pais": "", "cliente_direccion": "Av.", "cliente_email": "", "cliente_telefono": "" }, "items": [ { "unidad": "NIU", "codigo": "", "descripcion": "test", "cantidad": 1, "precio": 100, "tipo_tax": "1" } ], "observaciones": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Estructura para generar Guias - Remitente **POST**`https://api.factpro.la/api/v3/guias` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body**
ATRIBUTOVALORREQUISITOLONGUITUD
tipo_documento11 = GRE - RemitenteObligatorio2 exacto
serieDebe ingresar "T" para GUIAS DE REMISIÓN REMITENTE .Obligatorio4 exacto
numeroNúmero correlativo del documentoObligatorio1 hasta 8
fecha_de_trasladoDebe ser la fecha igual o posterior a la emisión . Ejemplo: 2021-05-14Obligatorio10 exacto
codigo_modo_transporte

Sólo para GRE Remitente

"01" = "TRANSPORTE PÚBLICO"

"02" = "TRANSPORTE PRIVADO"

Obligatorio2 exacto
motivo_traslado

"01" = "Venta"

"02" = "Compra"
"03" = "Venta con entrega a terceros"
"04" = "Traslado entre establecimientos de la misma empresa"
"05" = "Consignación"
"06" = "Devolucion"
"07" = "Recojo de bienes transformados"
"08" = "Importación"
"09" = "Exportación"

"13" = "Otros"

Obligatorio2 exacto
Descripcion_motivo_trasladoSolo se aplica para Motivo de traslado: “13” - OTROS Descripción adicional alfanumérico con espaciados simplesOpcionalHasta 60 caracteres.
peso_bruto_unidad

Código de la unidad de medida, solo se aceptan:

KGM = “Kilogramos” ó TNE = “Toneladas”

Obligatorio3 exacto
peso_bruto_totalEn KILOGRAMOS, ejemplo: 4.00 Importante: debe ser mayor a “0”.Obligatorio

1 hasta 12 enteros,

hasta con 10 decimales

numero_de_bultos

GRE Remitente

Cantidad de bultos. Importante: debe ser numérico (entero)

Obligatorio1 hasta 6 enteros
DATOS DEL DESTINATARIO
cliente_tipo_documento

4 = RUC - REGISTRO ÚNICO DE CONTRIBUYENTE

2 = DNI - DOC. NACIONAL DE IDENTIDAD

3 = CARNET DE EXTRANJERÍA

5 = PASAPORTE

1 = NO DOMICILIADO, SIN RUC

Obligatorio1 exacto
cliente_numero_documentoEjemplo: RUC del CLIENTE, número de DNI, Etc.Obligatorio1 hasta 15
cliente_denomicacionNombre o Razón socialObligatorio1 hasta 100
codigo_paisPE = PERÚOpcional2 exacto
ubigeoEjemplo: 150101Opcional6 exacto
cliente_direccionEjemplo: Av. Central 122Obligatorio1 hasta 100
cliente_emailDirección de email debe ser válidoOpcional1 hasta 200
cliente_telefonoNúmero de teléfonoOpcional1 hasta 20
3 exacto
TRANSPORTISTAAplica solo para modo de transporte = 01
transportista_numero_documento6 = RUC - REGISTRO ÚNICO DE CONTRIBUYENTE Sólo cuando 'tipo_de_transporte' es "01"Condicional1 exacto
transportista_denominacion

Razón o nombre completo del TRANSPORTISTA.

Sólo cuando 'tipo_de_transporte' es "01"


Condicional1 hasta 100
numero_registro_mtcAlfanumérico Mayúsculas.Opcionalhasta 20
CONDUCTORAplica solo para modo de transporte = 02
conductor_tipo_documento

2 = DNI - DOC. NACIONAL DE IDENTIDAD

3 = CARNET DE EXTRANJERÍA

5 = PASAPORTE

1 = NO DOMICILIADO, SIN RUC

Condicional1 exacto
conductor_numero_documentoEjemplo: RUC del CLIENTE, número de DNI, Etc.Condicional1 hasta 15
conductor_apellidos_y_nombresNombre completo del conductorCondicional1 hasta 100
conductor_numero_licenciaNúmero de licencia del conductorCondicional9 hasta 10
conductor_numero_de_placaNúmero de placa del vehículo

Ejemplo: ACE321 (no deben ser ceros ni debe tener guiones)		Condicional6 hasta 8
numero_registro_mtcAlfanumérico Mayúsculas.Opcionalhasta 20
DIRECCIÓN DE PARTIDA
ubigeoEjemplo: 150101ObligatorioHasta 6
direccionEjemplo: Av. Central 122Obligatorio1 hasta 100
DIRECCIÓN DE LLEGADA
ubigeoEjemplo: 150101ObligatorioHasta 6
direccionEjemplo: Av. Central 122Obligatorio1 hasta 100
OTROS
observacionesTexto de 0 hasta 1000 caracteres.Opcional
numero_de_contenedorVacío
formato_pdfa4Obligatorio
ITEM
codigoCódigo interno del producto o servicio, asignado por ti.Opcional1 hasta 250
cantidadEjemplo: 10.00Obligatorio

1 hasta 12 enteros,

hasta con 10 decimales

descripcionDescripción del producto o servicio. Obligatorio1 hasta 250
unidad

NIU = PRODUCTO

ZZ = SERVICIO

Importate: En caso de que el motivo sea Importación o Exportación debe usar las unidades de medida del Catálogo 65 SUNAT(para uso solo para la GRE en DAM o DS) . Ver unidades

Obligatorio2 hasta 5
INDICADOR DE ENVIO
envio_indicador

GRE Remitente
Debes de enviar el numero :

6 = SUNAT_Envio_IndicadorTrasladoVehiculoM1L


Opcional1 exacto
# Modalidad Transporte publico Se puede utilizar para crear ventas como factura o boleta electrónica **POST**`https://api.factpro.la/api/v3/guias` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "tipo_documento": "11", "serie": "T001", "numero": "#", "fecha_de_traslado": "2026-01-08", "codigo_modo_transporte": "01", "motivo_traslado": "01", "descripcion_motivo_traslado": "", "peso_bruto_unidad": "KGM", "peso_bruto_total": "2", "numero_de_bultos": "1", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20606615044", "cliente_denominacion": "TRADING VELTOR S.A.C.", "codigo_pais": "", "ubigeo": "", "cliente_direccion": "AV.CALLAO - CALLAO - CALLAO", "cliente_email": "", "cliente_telefono": "" }, "transportista": { "transportista_numero_documento": "20551604811", "transportista_denominacion": "IHERMANOS S.A.C.", "numero_registro_mtc": "" }, "conductor": { "conductor_tipo_documento": "", "conductor_numero_documento": "", "conductor_nombres_y_apellidos": "", "conductor_numero_licencia": "", "conductor_numero_de_placa": "" }, "direccion_partida": { "ubigeo": "150119", "direccion": "CALURB. HUERTOS DE LURIN" }, "direccion_llegada": { "ubigeo": "070101", "direccion": "AV.- CALLAO - CALLAO" }, "observaciones": "", "codigo_de_puerto": "", "indicador_de_transbordo": false, "numero_de_contenedor": "", "formato_pdf": "a4", "items": [ { "codigo": "100", "cantidad": "1", "descripcion": "Celular", "unidad": "NIU" } ], "envio_indicador": "" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # M1/L ## Indicador de traslado en vehículos de categoría M1 o L — GRE SUNAT ### ¿Qué significa M1/L? El indicador **M1/L** en la Guía de Remisión Electrónica (GRE) permite señalar que el traslado de los bienes se realiza utilizando un vehículo perteneciente a las categorías vehiculares **M1 o L**. Si no cuentas con datos de transportista y datos de conductor placa, puedes activar la opción M1 / L . #### Categoría M1 La categoría **M1** corresponde a vehículos destinados principalmente al transporte de personas, que cuentan con hasta ocho asientos además del asiento del conductor. Ejemplos habituales: * Automóviles. * Camionetas. * Vehículos similares destinados al transporte de personas. #### Categoría L La categoría **L** comprende vehículos motorizados de dos, tres o más ruedas, según la clasificación vehicular correspondiente. Ejemplos: * Motocicletas. * Mototaxis y vehículos similares, según su clasificación. *** ### ¿Cuándo se activa M1/L en la GRE? El indicador debe activarse **únicamente cuando el traslado de los bienes efectivamente se realiza utilizando un vehículo que pertenece a la categoría M1 o L**. No debe activarse simplemente porque el vehículo sea pequeño, liviano o particular. Lo importante es la **categoría vehicular que corresponde al vehículo utilizado para el traslado**. *** ### ¿Qué efecto tiene activar M1/L? El indicador informa a SUNAT que el traslado se realiza mediante un vehículo de categoría **M1 o L**. Su activación puede tener consecuencias respecto de la obligación de emitir la **GRE-Transportista**, dependiendo de las condiciones y modalidad del traslado. Por ello, **M1/L no debe interpretarse como una opción general para indicar que el vehículo es propio o particular**. *** **POST**`https://api.factpro.la/api/v3/guias` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "tipo_documento": "11", "serie": "T001", "numero": "#", "fecha_de_traslado": "2026-01-08", "codigo_modo_transporte": "01", "motivo_traslado": "01", "descripcion_motivo_traslado": "", "peso_bruto_unidad": "KGM", "peso_bruto_total": "2", "numero_de_bultos": "1", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20606615044", "cliente_denominacion": "TRADING VELTOR S.A.C.", "codigo_pais": "", "ubigeo": "", "cliente_direccion": "AV.CALLAO - CALLAO - CALLAO", "cliente_email": "", "cliente_telefono": "" }, "transportista": { "transportista_numero_documento": "", "transportista_denominacion": "", "numero_registro_mtc": "" }, "conductor": { "conductor_tipo_documento": "", "conductor_numero_documento": "", "conductor_nombres_y_apellidos": "", "conductor_numero_licencia": "", "conductor_numero_de_placa": "" }, "direccion_partida": { "ubigeo": "150119", "direccion": "CALURB. HUERTOS DE LURIN" }, "direccion_llegada": { "ubigeo": "070101", "direccion": "AV.- CALLAO - CALLAO" }, "observaciones": "", "codigo_de_puerto": "", "indicador_de_transbordo": false, "numero_de_contenedor": "", "formato_pdf": "a4", "items": [ { "codigo": "100", "cantidad": "1", "descripcion": "Celular", "unidad": "NIU" } ], "envio_indicador": "6" //Esto activa la opcion M1/L } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Modalidad Transporte privado Se puede utilizar para crear ventas como factura o boleta electrónica **POST**`https://api.factpro.la/api/v3/guias` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "tipo_documento": "11", "serie": "T001", "numero": "#", "fecha_de_traslado": "2026-08-08", "codigo_modo_transporte": "02", "motivo_traslado": "01", "descripcion_motivo_traslado": "--", "peso_bruto_unidad": "KGM", "peso_bruto_total": "1", "numero_de_bultos": "1", "cliente": { "cliente_tipo_documento": "4", "cliente_numero_documento": "20606615044", "cliente_denominacion": "TRADING VELTOR S.A.C.", "codigo_pais": "", "ubigeo": "", "cliente_direccion": "AV.CALLAO - CALLAO - CALLAO", "cliente_email": "", "cliente_telefono": "" }, "transportista": { "transportista_numero_documento": "", "transportista_denominacion": "", "numero_registro_mtc": "" }, "conductor": { "conductor_tipo_documento": "2", "conductor_numero_documento": "72533573", "conductor_nombres_y_apellidos": "conductor nombre", "conductor_numero_licencia": "Q72533573", "conductor_numero_de_placa": "AHA025" }, "direccion_partida": { "ubigeo": "150119", "direccion": "CALURB. HUERTOS DE LURIN" }, "direccion_llegada": { "ubigeo": "070101", "direccion": "AV.- CALLAO - CALLAO" }, "observaciones": "", "codigo_de_puerto": "", "indicador_de_transbordo": false, "numero_de_contenedor": "", "formato_pdf": "a4", "items": [ { "codigo": "1", "cantidad": "1", "descripcion": "napa", "unidad": "NIU" } ], "envio_indicador": "" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Traslado entre almacenes Se puede utilizar para crear ventas como factura o boleta electrónica **POST**`https://api.factpro.la/api/v3/guias` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "tipo_documento": "09", "serie": "T001", "numero": "#", "fecha_de_traslado": "2026-01-06", "codigo_modo_transporte": "01", "motivo_traslado": "04", "descripcion_motivo_traslado": "--", "peso_bruto_unidad": "KGM", "peso_bruto_total": "1", "numero_de_bultos": "1", "transportista": { "transportista_numero_documento": "20512528458", "transportista_denominacion": "SHALOM", "numero_registro_mtc": "" }, "conductor": { "conductor_tipo_documento": "", "conductor_numero_documento": "", "conductor_nombres_y_apellidos": "", "conductor_numero_licencia": "", "conductor_numero_de_placa": "" }, "direccion_partida": { "ubigeo": "150101", "direccion": "PUNTO A", "anexo_de_partida":"0000" }, "direccion_llegada": { "ubigeo": "150101", "direccion": "PUNTO B", "anexo_de_llegada":"0000" }, "observaciones": "", "codigo_de_puerto": "", "indicador_de_transbordo": false, "numero_de_contenedor": "", "formato_pdf": "a4", "items": [ { "codigo": "1", "cantidad": "1", "descripcion": "napa", "unidad": "NIU" } ], "envio_indicador": "" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Venta con entrega a terceros Se puede utilizar para crear ventas como factura o boleta electrónica **POST**`https://api.factpro.la/api/v3/guias` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "tipo_documento": "11", "serie": "T001", "numero": "#", "fecha_de_traslado": "2026-08-06", "hora_de_emision": "", "codigo_modo_transporte": "01", "motivo_traslado": "03", "descripcion_motivo_traslado": "-", "peso_bruto_unidad": "KGM", "peso_bruto_total": "1", "numero_de_bultos": "1", "cliente":{ "cliente_tipo_documento": "4", "cliente_numero_documento": "20606615044", "cliente_denominacion": "TRADING VELTOR S.A.C.", "codigo_pais": "", "ubigeo": "", "cliente_direccion": "AV.CALLAO - CALLAO - CALLAO", "cliente_email": "", "cliente_telefono": "", "codigo_establecimiento": "0000" }, "comprador":{ "comprador_tipo_documento": "4", "comprador_numero_documento": "20606615044", "comprador_denominacion": "TRADING VELTOR S.A.C." }, "transportista": { "transportista_numero_documento": "20131370564", "transportista_denominacion": "SHALOM EMPRESARIAL S.A.C", "numero_registro_mtc": "" }, "conductor": { "conductor_tipo_documento": "", "conductor_numero_documento": "", "conductor_nombres_y_apellidos": "", "conductor_numero_licencia": "", "conductor_numero_de_placa": "" }, "direccion_partida": { "ubigeo": "150101", "direccion": "PUNTO A" }, "direccion_llegada": { "ubigeo": "150101", "direccion": "PUNTO B" }, "items":[ { "codigo": "", "cantidad": 2, "descripcion": "MacbookPro", "unidad": "NIU" } ], "observaciones": "", "codigo_de_puerto": "", "indicador_de_transbordo": false, "numero_de_contenedor": "", "formato_pdf": "a4" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-82", "archivo": "20466590247-01-F100-82", "letras": "Setenta y nueve con 69/100 ", "hash": "uJvcwN2kh/mOaR5pU9mhu1hc7zs=", "qr": "lJIMsDNoAAAAASUVORK5CYII=", "tipo_estado": "01", "descripcion_estado": "REGISTRADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-01-F100-82.pdf", "xml": "https://api.factpro.la/invoice/20466590247-01-F100-82.xml", "cdr": "" }, "eventos": [ { "date": "2025-07-16 12:16:46.564547", "description": "El documento ha sido registrado y enviado" } ] } ``` {% endtab %} {% tab title="false" %} ```json { "exito": false, "mensaje": null, } ``` {% endtab %} {% endtabs %} # Consultar documentos Disponble para consultar: Facturas, Boletas, Nota de créditos y Nota de débitos **POST**`https://api.factpro.la/api/v3/consulta` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F100", "numero": 61 } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-61", "archivo": "20466590247-01-F100-61", "letras": "Cien con 00/100 ", "hash": "Slhxy95DqLmoi5vxDpC7u6c89b4=", "qr": "Nkz9Sy8AAAAASUVORK5CYII=", "tipo_estado": "05", "descripcion_estado": "ACEPTADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20460590200-01-F100-61.pdf", "xml": "https://api.factpro.la/invoice/20460590200-01-F100-61.xml", "cdr": "https://api.factpro.la/invoice/20460590200-01-F100-61.cdr" }, "eventos": [ { "date": "2025-07-11 14:08:51.151033", "description": "El documento ha sido registrado y enviado" }, { "date": "2025-07-11 14:11:45.428059", "description": "La Factura numero F100-61, ha sido aceptada" } ] } ``` {% endtab %} {% endtabs %} # Recuperar CDR Disponble para consultar: Facturas, Boletas, Nota de créditos y Nota de débitos **POST**`https://api.factpro.la/api/v3/documentos/cdr` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F100", "numero": 61 } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "data": { "numero": "F100-61", "archivo": "20466590247-01-F100-61", "letras": "Cien con 00/100 ", "hash": "Slhxy95DqLmoi5vxDpC7u6c89b4=", "qr": "Nkz9Sy8AAAAASUVORK5CYII=", "tipo_estado": "05", "descripcion_estado": "ACEPTADO" }, "archivos": { "pdf": "https://api.factpro.la/invoice/20460590200-01-F100-61.pdf", "xml": "https://api.factpro.la/invoice/20460590200-01-F100-61.xml", "cdr": "https://api.factpro.la/invoice/20460590200-01-F100-61.cdr" }, "eventos": [ { "date": "2025-07-11 14:08:51.151033", "description": "El documento ha sido registrado y enviado" }, { "date": "2025-07-11 14:11:45.428059", "description": "La Factura numero F100-61, ha sido aceptada" } ] } ``` {% endtab %} {% endtabs %} # Anular documento Disponble para consultar: Facturas, Boletas, Nota de créditos y Nota de débitos **POST**`https://api.factpro.la/api/v3/anular` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body** ```json { "serie": "F001", "numero": "5044", "motivo": "ERROR DEL SISTEMA" } ``` **Response** {% tabs %} {% tab title="true" %} ```json { "exito": true, "mensaje": null, "ticket": "1753907311069", "hash": "", "fecha_de_emision": "2025-07-30", "estado_documento": "03-ENVIADO", "archivos": { "pdf": "https://api.factpro.la/invoice/20466590247-RA-20250730-2722.pdf", "xml": "https://api.factpro.la/invoice/20466590247-RA-20250730-2722.xml", "cdr": "https://api.factpro.la/invoice/20466590247-RA-20250730-2722.cdr" }, "eventos": [ { "date": "2025-07-30 15:27:22.653080", "description": "La anulacion ha sido registrado y enviado" } ] } ``` {% endtab %} {% endtabs %} # API consulta RUC y DNI
Para obtener nuestra version gratuita e ilimtada solo debes de obtener un servicio de pago con nosotros.\ \ La url para crearte tu cuenta es el mismo dashboard.factpro.la, cabe mencionar que cada servicio maneja su token del cual es diferente con facturacion y sire Caso contrario En el plan free tienes 30 consultas mensuales incluye: consulta RUC, DNI, TIPO DE CAMBIO, anexos Para activar y obtener el token de consultas: \ En el menú dale clic a > integración > luego busca e ingresa en la tarjeta "CONSULTA DNI/RUC/TIPO DE CAMBIO" > finalmente dale clic en "activar" y obtendras tu token del servicio. # Búsqueda por número de RUC **Método** GET **URL:** (Obtener datos de empresa por RUC). **Header**
NameValue
AuthorizationBearer {token_empresa}
**Response** ```json { "ruc": "20337564373", "nombre": "TIENDAS POR DEPARTAMENTO RIPLEY S.A.C.", "estado": "ACTIVO", "condicion": "HABIDO", "direccion": "AV. LAS BEGONIAS NRO. 545 URB. JARDIN", "direccion_completa": "AV. LAS BEGONIAS NRO. 545 URB. JARDIN LIMA LIMA SAN ISIDRO", "ubigeo": "150131", "departamento": "LIMA", "provincia": "LIMA", "distrito": "SAN ISIDRO", "tipo_via": "AV.", "nombre_via": "LAS BEGONIAS", "codigo_zona": "URB.", "tipo_zona": "JARDIN", "numero": "545", "interior": "", "lote": "", "dpto": "", "manzana": "", "kilometro": "" } ``` # Búsqueda Anexos - RUC **Método** GET **URL:** (Obtener datos los anexos/establecimientos por RUC). **Header**
NameValue
AuthorizationBearer {token_empresa}
**Response** ```json [ { "ruc": "20337564373", "direccion": "AV. MRCAL. OSCAR. R BENAVIDES NRO. 3866 URB. EL AGUILA", "direccion_completa": "AV. MRCAL. OSCAR. R BENAVIDES NRO. 3866 URB. EL AGUILA CALLAO CALLAO BELLAVISTA", "ubigeo": "070102", "departamento": "CALLAO", "provincia": "CALLAO", "distrito": "BELLAVISTA", "tipo_via": "AV.", "nombre_via": "MRCAL. OSCAR. R BENAVIDES", "codigo_zona": "URB.", "tipo_zona": "EL AGUILA", "numero": "3866", "interior": "", "lote": "", "dpto": "", "manzana": "", "kilometro": "" }, { "ruc": "20337564373", "direccion": "AV. EL SOL NRO. 2241 ---- ASOCIACIÓN AGROPECUARIA V", "direccion_completa": "AV. EL SOL NRO. 2241 ---- ASOCIACIÓN AGROPECUARIA V LIMA LIMA VILLA EL SALVADOR", "ubigeo": "150142", "departamento": "LIMA", "provincia": "LIMA", "distrito": "VILLA EL SALVADOR", "tipo_via": "AV.", "nombre_via": "EL SOL", "codigo_zona": "----", "tipo_zona": "ASOCIACIÓN AGROPECUARIA V", "numero": "2241", "interior": "", "lote": "", "dpto": "", "manzana": "", "kilometro": "" }, { "ruc": "20337564373", "direccion": "AV. AUTOP.CTO GRANDRE-FLORES NRO. SN", "direccion_completa": "AV. AUTOP.CTO GRANDRE-FLORES NRO. SN LIMA LIMA SAN JUAN DE LURIGANCHO", "ubigeo": "150132", "departamento": "LIMA", "provincia": "LIMA", "distrito": "SAN JUAN DE LURIGANCHO", "tipo_via": "AV.", "nombre_via": "AUTOP.CTO GRANDRE-FLORES", "codigo_zona": "", "tipo_zona": "", "numero": "SN", "interior": "", "lote": "", "dpto": "", "manzana": "", "kilometro": "" }, { "ruc": "20337564373", "direccion": "AV. GENERAL FELIPE SALAVERRY NRO. 2370 LOTE. 216", "direccion_completa": "AV. GENERAL FELIPE SALAVERRY NRO. 2370 LOTE. 216 LIMA LIMA JESUS MARIA", "ubigeo": "150113", "departamento": "LIMA", "provincia": "LIMA", "distrito": "JESUS MARIA", "tipo_via": "AV.", "nombre_via": "GENERAL FELIPE SALAVERRY", "codigo_zona": "", "tipo_zona": "", "numero": "2370", "interior": "", "lote": "216", "dpto": "", "manzana": "", "kilometro": "" }, ] ``` # Consulta DNI **Método** GET **URL:** (Obtener datos de empresa por DNI). **Header**
NameValue
AuthorizationBearer {token_empresa}
**Response** ```json { "nombres": "LAVERIO ANGHELO" } ``` # API consulta Tipo de cambio Para obtener nuestra version gratuita e ilimtada solo debes de obtener un servicio de pago con nosotros.\ \ La url para crearte tu cuenta es el mismo dashboard.factpro.la, cabe mencionar que cada servicio maneja su token del cual es diferente con facturacion y sire Caso contrario En el plan free tienes 30 consultas mensuales incluye: consulta RUC, DNI, TIPO DE CAMBIO, anexos Para activar y obtener el token de consultas: \ En el menú dale clic a > integración > luego busca e ingresa en la tarjeta "CONSULTA DNI/RUC/TIPO DE CAMBIO" > finalmente dale clic en "activar" y obtendras tu token del servicio. # Tipo de cambio: Por día **Método** GET **URL: ** **Header**
NameValue
AuthorizationBearer {token_empresa}
**Response** ```json { "fecha": "2024-08-07", "compra": 3.744, "venta": 3.754 } ``` # Tipo de cambio: Último día **Método** GET **URL: ** **Header**
NameValue
AuthorizationBearer {token_empresa}
**Response** ```json { "fecha": "2024-08-07", "compra": 3.744, "venta": 3.754 } ``` # Tipo de cambio: Por mes **Método** GET **URL: ** **Header**
NameValue
AuthorizationBearer {token_empresa}
**Response** ```json [ { "fecha": "2024-08-07", "compra": 3.744, "venta": 3.754 }, { "fecha": "2024-08-06", "compra": 3.744, "venta": 3.754 }, { "fecha": "2024-08-05", "compra": 3.74, "venta": 3.748 }, { "fecha": "2024-08-04", "compra": 3.74, "venta": 3.748 }, { "fecha": "2024-08-03", "compra": 3.74, "venta": 3.748 }, { "fecha": "2024-08-02", "compra": 3.733, "venta": 3.741 }, { "fecha": "2024-08-01", "compra": 3.712, "venta": 3.722 } ] ``` # API SIRE
Para obtener nuestra version gratuita e ilimtada solo debes de obtener un servicio de pago con nosotros.\ \ La url para crearte tu cuenta es el mismo dashboard.factpro.la, cabe mencionar que cada servicio maneja su token del cual es diferente con facturación y consultas Caso contrario En el plan free tienes 2 consultas mensuales. Para activar y obtener el token de consultas: \ En el menú dale clic a > integración > luego busca e ingresa en la tarjeta "SIRE > finalmente dale clic en "activar" y obtendrás tu token del servicio. # Configuración Antes de integrar el SIRE se debe de realizar dos configuraciones vía SUNAT y PANEL de factpro. 1- Primero debemos de generar el token en el PANEL ( ) de factpro, al generar lo usaremos para poder conectarnos a los **endpoints**
2- En SUNAT con su clave SOL, deberán habilitar el API token
3- En la siguiente vista explicaremos que se deberá de realizar: 3.1. Nombre: colocar un nombre referencial, no necesariamente el nombre del sistema\ 3.2. URL: ingresar un URL referencia, no necesariamente del sistema\ 3.3. ID y CLAVE: se obtiene al guardar estos datos serán ingresado al sistema.\ 3.4 Seleccionar MIGE (esto sirve para el SIRE) y GRE ( Si usarán guías pueden activar opcional )\ 3.5 Seleccionar “Desktop”
4 - En el sistema debemos de ingresar en “API TOKEN” Aquí será importante colocar lo datos de la empresa :\ Usuario SOL principal\ Clave SOL principal\ ID: obtenido de SUNAT ( paso 3)\ Clave: obtenido de SUNAT ( paso 3)
Al ingresar todos los datos requeridos, dar clic en **“VALIDAR y GUARDAR” :** # Compras - Descargar Propuesta **POST**`https://sire.factpro.la/api/compras/descargar-propuesta` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body**
NameTypeDescription
nombreStringAño a consultar ( Ejemplo : 2024 )
mesStringMes a consultar ( Ejemplo : 05 = Mayo )
**Ejemplo** ```json { "año": "2024", "mes": "05" } ``` **Response**: ```json { "estado": 200, "mensaje": "Descarga propuesta RCE correctamente.", "ticket": "2024030003434448" } ``` # Compras - Consulta detalle de comprobantes - Propuesta **POST**`https://sire.factpro.la/api/compras/listar-propuesta` **Headers**
NameValue
Content-Typeapplication/json
AuthorizationBearer <token>
**Body**
NameTypeDescription
ticketStringIngresar el número de ticket a consultar
**Ejemplo** ```json { "ticket": "2024030000034343" } ``` **Response**: ```json { "estado": 200, "mensaje": "Consulta propuesta RCE correctamente.", "registros": [ { "numRuc": "20609753120", "nomRazonSocial": "FACTPRO LATAM E.I.R.L.", "periodo": "202434", "codCar": "2061046021701E0013434345", "fecEmision": "18/06/2024", "fecVencPag": "", "codTipoCDP": "01", "desTipoCDP": "Factura", "numSerieCDP": "E001", "añoDUA": "", "numCDP": "105", "numCDPRangoFinal": "", "codTipoDocIdentidadProveedor": "6", "numDocIdentidadProveedor": "20610460223", "nomRazonSocialProveedor": "SAC E.I.R.L.", "montos": { "mtoBIGravadaDG": "2490.18", "mtoIgvIpmDG": "448.23", "mtoBIGravadaDGNG": "0.00", "mtoIgvIpmDGNG": "0.00", "mtoBIGravadaDNG": "0.00", "mtoIgvIpmDNG": "0.00", "mtoValorAdqNG": "0.00", "mtoISC": "0.00", "mtoIcbp": "0.00", "mtoOtrosTrib": "0.00", "importeTotal": "2938.41" }, "codMoneda": "USD", "tipoCambio": "3.796", "modificacion": { "fecModif": "", "tipoCPModif": "", "serieCPModif": "", "codDAM": "", "numModif": "" }, "codBbss": "", "codIdProyecto": "", "porcPart": "", "IMB": "0.00", "indIncluExcluCar": "", "indDetraccion": "", "tipoNota": "", "estComp": "1", "incal": "0" }, ] } ``` # Importar masivo por excel VIDEO: **Guía Paso a Paso: Emisión Masiva de Facturas en Factpro** Este documento detalla el procedimiento para emitir facturas o boletas de forma masiva utilizando una plantilla de Excel en la plataforma Factpro. **Fase 1: Preparación y Descarga en el Sistema** 1. **Ingresar al Sistema:** Inicia sesión en el panel principal de Factpro. 2. **Navegar al Módulo:** Haz clic en la opción **Documento** ubicada en el menú principal. 3. **Seleccionar la Opción de Carga:** Dirígete a la opción denominada **Carga masiva**. 4. **Configurar los Parámetros de Emisión:** En la vista de carga masiva, selecciona cuidadosamente las siguientes opciones: * **Establecimiento:** Selecciona la sucursal u oficina emisora. (*Nota: Asegúrate de que la sucursal seleccionada tenga la serie del comprobante registrada*). * **Tipo de Documento:** Indica si emitirás Factura (F001 o Boleta (B001), verifica las series que tienes creado en el panel de factpro, desde configuración > sucursal > series (OBLIGATORIO). * **Moneda:** Selecciona el tipo de moneda (Soles o Dólares). * **Impuesto:** Define el impuesto aplicable para los comprobantes. 5. **Descargar la Plantilla:** Haz clic en el botón para descargar la plantilla de Excel. Se recomienda realizar este paso cada vez que se vaya a subir información nueva para asegurarse de tener el formato correcto. **Fase 2: Llenado Correcto de la Plantilla de Excel** 6. **Ingresar los Datos del Cliente:** Abre el archivo Excel descargado y completa las columnas requeridas para cada transacción: * **Vencimiento:** Puede dejarse vacío si no hay una fecha de vencimiento específica. * **Tipo de documento:** Es importante para identificar si es DNI,CE,PASAPORTE O RUC, debes de colocar el codigo : 1 = otros | 2 = DNI | 3 = CE | 4 = RUC | 5 = PASAPORTE * **DNI / RUC:** Coloca el número de identificación del cliente (Numero de DNI,PASAPORTE,CE o empresa. En el caso de facturas, siempre debe ingresarse un RUC (que inicia con 10, 15 o 20). * **Denominación:** Escribe la Razón Social de la empresa o los Nombres y Apellidos en caso de usar DNI,pasaporte, o Carné de Extranjería. * **Moneda:** Mantén el valor tal cual indica la plantilla para la moneda seleccionada (ej. PEN para soles). * **Correo y Dirección:** Estos campos son opcionales; puedes dejarlos vacíos o agregar la información del cliente si lo requieres. 7. **Uso Correcto de la Columna "Fila" (Gestión de Ítems):** \* La columna **Fila** es fundamental para agrupar ítems (productos o servicios) dentro de un mismo comprobante. * **Múltiples ítems en una factura:** Si una factura contiene varios productos con diferentes precios o cantidades, debes agruparlos utilizando el mismo número en la columna "Fila". Por ejemplo, el ítem 1 y el ítem 2 tendrán ambos el número "1" en la columna Fila para indicar que pertenecen a la misma factura. * **Diferentes facturas:** Si se trata de comprobantes distintos, asigna un número diferente a cada uno (Fila 1 para la primera factura, Fila 2 para la segunda, etc.). * *Importante:* Los números en la columna "Fila" **no corresponden** al número correlativo del comprobante físico o electrónico (ej. F001-0001). El sistema Factpro asigna el correlativo de forma completamente automática. 8. **Restricciones de la Plantilla:** **NO** se pueden agregar columnas adicionales al archivo Excel. Una vez completado, guarda los cambios. **Fase 3: Carga y Validación** 9. **Subir la Plantilla:** Regresa al panel de Factpro (en la misma vista de Carga masiva) y sube el archivo Excel que acabas de guardar. 10. **Revisión Previa:** El sistema procesará el archivo subido y te mostrará un resumen de la información en pantalla. Podrás verificar visualmente cómo se agrupan los ítems (por ejemplo, el sistema indicará: "La factura 1 tiene 2 ítems"). 11. **Procesar la Información:** Si la información previa es correcta, haz clic en el botón de **Procesar**. 12. **Confirmación:** Espera un momento. El sistema emitirá un mensaje confirmando que los **"Documentos han sido cargados con éxito"**. 13. **Verificación Final:** Dirígete al apartado de **Facturas** en el menú principal. Allí aparecerán listados todos los comprobantes electrónicos que se acaban de generar para su posterior envío. # Registro de usuarios Para agregar un usuario a una empresa: 1. Ingresa al menú **Ajustes**. 2. Selecciona la opción **Usuarios**.
3. En la parte inferior de la pantalla encontrarás dos formas de agregar usuarios a la empresa seleccionada: ### Opción 1: Crear un nuevo usuario Utiliza esta opción cuando la persona aún no está registrada en la plataforma. Completa los siguientes datos: * Nombre * Correo electrónico * Contraseña Luego, guarda la información para crear y vincular al usuario con la empresa seleccionada. ### Opción 2: Vincular un usuario existente Si la persona ya está registrada en la plataforma: 1. Selecciona la opción **Buscar usuarios**. 2. Ingresa el correo electrónico del usuario. 3. Selecciona al usuario encontrado para vincularlo con la empresa. ### Importante Por el momento, el usuario asignado tendrá los mismos roles y permisos que tu usuario. El usuario solo podrá acceder a la empresa o RUC con el que fue vinculado. Si deseas darle acceso a otra empresa o RUC, deberás repetir este proceso seleccionando previamente la empresa correspondiente. # Limite de solicitudes excedido Motivo: es porque llego al limite tu plan, puede ser en un ambiente de prueba o de pago, para ayudarte podemos generar un ticket de seguimiento para que el equipo ANALICE tu caso, enviemos el correo principal con el que estas registrado # Eliminar todos los documentos de pruebas en demo Te recomendamos eliminar todos los documentos de pruebas y validar el correlativo, en factpro cuando vas generando documento el correlativo va avanzando, ejemplo : F001-1, F001-2.... 1. Ve al menú > luego haz clic en> integración > Finalmente veras un botón rojo:> ELIMINAR 2. En el menú > ingresa a > ajustes> luego haz clic en > sucursal > series > en la columna " Comenzar con" debes de indicar desde que numero vas iniciar . Importante solo es posible eliminar documentos en ambiente de pruebas, en producción no será posible # Editar un documento en estado REGISTRADO Si requieres editar un documento en estado REGISTRADO, si es posible corregir mientras no este rechazado, el proceso es igual al crear, solo varia en lo siguiente 1. PUT > 2. Lo que no debes de cambiar es: "serie": "F100", "numero": "Aquí enviar el mismo numero generado", 3. Puedes cambiar los otros campos, sin embargo la idea de esta opción es si te equivocas de cliente, tipo , nombre de item, precio. # M1/L GUIA DE REMISION DE REMITENTE:\ Si en caso no tienes dato de conductor, placa, licencia, y transportista, entonces debes de enviar como M1/L , si te parece te envio los pasos # CDR * **Proceso:** Creación de XML $\to$ Firma en servidor de Factpro $\to$ Envío inmediato a SUNAT $\to$ Recepción del CDR. * **Ventaja:** Obtienes el estado de "Aceptado" en cuestión de segundos. * **Consideración:** El sistema seguirá operando, pero la velocidad de generación dependerá de la latencia y disponibilidad del servidor de SUNAT, lo que puede generar ligeras demoras. Características del proceso con la opción de CDR Automático ACTIVADA (Aceptación Inmediata): Características del proceso con la opción de CDR Automático DESACTIVADA (Alta Velocidad y Tolerancia a Fallos): * **Proceso:** Generación inmediata del comprobante en el sistema. El envío a SUNAT se delega a una tarea en segundo plano que se ejecuta cada 5 minutos. * **Ventaja:** Si los servicios de SUNAT están fallando o lentos, puedes seguir generando documentos de forma rápida y sin bloqueos para el usuario. Pasos para activar el CDR Automático para obtener el estado aceptado de manera inmediata: 1. En el menú lateral izquierdo, ingresa a **Ajustes**. 2. Selecciona la pestaña **Apps**. 3. En la lista, ubica el tipo **FIRMA** y haz clic en el ícono de edición (lápiz) ubicado en la columna de acciones. 4. En el modal emergente, activa el interruptor **Obtener CDR automático en documentos**. 5. Haz clic en **Guardar**. # 🚚 Guía: Activación de Guía de Remisión Electrónica (GRE) - SUNAT Para emitir Guías de Remisión desde el sistema, primero debes generar las credenciales API en el portal de SUNAT. #### Parte 1: Proceso de Autorización en SUNAT 1. Ingreso a Clave SOL: Accede al portal de SUNAT con tu RUC, Usuario y Clave SOL. 2. Ruta de acceso: \* Dirígete a la pestaña Empresas. * Busca la opción Credenciales de API SUNAT. * Selecciona Gestión de Credenciales de API SUNAT. 3. Registro de Aplicación: Completa los datos en el formulario de "Registre su Aplicación": * Nombre de aplicación: Coloca un nombre referencial (ej: `facturadort`). * URL de aplicación: Coloca una URL referencial (ej: `guia.com`). * Alcance (Scope): Selecciona la opción Desktop. * Servicios: Busca y selecciona la opción GRE Emisión de Comprobantes. * Haz clic en Guardar. 4. Obtención de Credenciales: Una vez guardado, el sistema de SUNAT te mostrará un ID y una CLAVE. Cópialos, ya que los necesitarás para el sistema. *** #### Parte 2: Configuración en el Sistema Una vez obtenidas las credenciales de SUNAT, debes ingresarlas en el panel de configuración de tu sistema: 1. Ve al MENU izquierdo, sección de INTEGRACION> busca la tarjeta> GUIAS > 2. Completa los siguientes campos obligatorios: * Usuario SOL: El usuario principal con el que accedes a SUNAT. (PRINCIPAL) * Clave SOL: La contraseña de acceso a SUNAT. * ID: El código obtenido en el paso 4 de la Parte 1. * CLAVE: La contraseña obtenida en el paso 4 de la Parte 1. 3. Validación: Haz clic en el botón Validar y Guardar. El sistema generará el token automáticamente para empezar a emitir guías. IMPORTANTE: 1 - Por un tema de SUNAT, este proceso puede implicar a cambiar de nombre o clave del usuario principal, porque SUNAT no reconoce, en caso si no se sincroniza , deberas de considerar esta observación. 2 - Si cambiar el usuario o clave de tu usuario SOL en sunat, debes de actualizarlo en el SISTEMA, puede dejar de enviarse las guías y salir rechazado
# CONFIGURACIÓN DE TIPO DE CAMBIO ( por web) Ajuste manual de la tasa de cambio para operaciones en moneda extranjera. Diríjase a la sección de Ajustes y seleccione Tipo de cambio. Verifique que la Moneda local seleccionada sea SOLES. Ingrese el valor numérico actual en el campo Tasa de cambio (ej. 3.39). Asegúrese de actualizar este valor diariamente según la publicación oficial de la SBS o SUNAT para evitar discrepancias en sus facturas en dólares. El sistema aplicará este valor automáticamente a todos los cálculos de conversión en los nuevos documentos. # GESTIÓN DE SERIES Y NUMERACIÓN (por web) Video: Contexto: Configuración de los correlativos y series para los diferentes tipos de comprobantes (Facturas, Boletas, Guías). Acceda a Ajustes y entre al módulo de Series. Para agregar una nueva, haga clic en el botón de la parte inferior. Seleccione el Tipo de documento (ejemplo: Guía de remisión remitente, Factura, etc.). Ingrese la Serie (ejemplo: F001 para facturas, T001 para transportistas). En el campo Comenzar con, coloque el número correlativo inicial (ejemplo: 1). Presione Guardar. Ahora, al emitir ese tipo de documento, el sistema seguirá la numeración configurada. # Web ACTUALIZACIÓN DE LOGOTIPO (por web) \ Carga o cambio de la imagen de marca que aparece en los documentos electrónicos. Ingrese a la sección de Ajustes > Logo. Haga clic en el icono de edición (lápiz) sobre el área del logo actual. Se abrirá el explorador de archivos de su computadora; seleccione el archivo de imagen (se recomienda formato PNG o JPG con fondo transparente). Una vez seleccionada la imagen, el sistema la cargará automáticamente. Asegúrese de que el logo sea legible para garantizar una presentación profesional en sus facturas. # Web: PERSONALIZACIÓN DE COLOR EN PDF (por web) Ajuste del color institucional en los archivos PDF de los comprobantes electrónicos. Vaya al menú de Ajustes y elija la opción PDF. Haga clic sobre el cuadro de color actual o el código HEX (ejemplo: #EDEDED). Utilice el selector visual para elegir el color deseado o pegue el código de color de su marca. Verifique la vista previa del tono seleccionado en la paleta. Los cambios se guardarán automáticamente y se aplicarán a todas las impresiones y descargas futuras. # REGISTRO DE CUENTA DE DETRACCIÓN (por web) Contexto: Configuración de la cuenta bancaria en el Banco de la Nación para servicios sujetos a detracción. Ingrese a Ajustes y seleccione el módulo de Cuentas Bancarias. Haga clic en el botón para agregar una Nueva Cuenta. En Tipo de cuenta bancaria, seleccione obligatoriamente CUENTA DETRACCION. Ingrese el número de cuenta proporcionado por el Banco de la Nación. Complete el campo Nombre (ej. "Cuenta Detracciones BN") y seleccione la moneda (Soles). Presione Guardar para que la cuenta esté disponible al aplicar detracciones en sus facturas. # CONFIGURACIÓN DE MONEDA (por web) Contexto: Gestión de los tipos de moneda (Soles, Dólares) habilitados para la facturación. Dirígete a Ajustes y selecciona la opción Monedas. En el listado, verifica las monedas que tienes activas para tu operación comercial. Si necesitas habilitar una nueva moneda, asegúrate de que esté configurada con el símbolo y código ISO correcto (ejemplo: PEN para Soles, USD para Dólares). Estos cambios permitirán que al emitir una factura puedas elegir entre las monedas configuradas. # CAMBIO DE RAZÓN SOCIAL Y NOMBRE COMERCIAL (por web) Actualización de la identidad legal y comercial de la empresa en el perfil del sistema. Acceda al menú de Ajustes y seleccione la opción Empresa. Localice los campos Denominación de la empresa (Razón Social) y Nombre comercial. Escriba los nuevos nombres tal como aparecen en su ficha RUC. Verifique que el número de identificación (RUC) coincida con la nueva denominación. Haga clic en el botón de Guardar para que los cambios se reflejen en los encabezados de sus comprobantes. # CÓMO CREAR UNA NUEVA SUCURSAL (por web) CÓMO CREAR UNA NUEVA SUCURSAL (por web)\ Contexto: Registrar un nuevo punto de venta o anexo. Entra a Configuración y luego a Sucursales. Haz clic en el botón Nuevo o Agregar en la parte superior. Ingresa el Código de establecimiento (son los 4 dígitos que SUNAT asigna a tu local). Escribe el nombre o descripción de la sede (ejemplo: "Tienda Principal"). Completa la dirección física completa y los datos de contacto. Haz clic en Guardar para activar la nueva sucursal. Video: # CÓMO VERIFICAR LOS DATOS DE TUS SEDES (por web) CÓMO VERIFICAR LOS DATOS DE TUS SEDES (por web)\ Contexto: Revisión de seguridad antes de emitir comprobantes. Ve al menú de Configuraciones y selecciona Sucursales. Revisa el listado de tus sedes activas. Compara que la dirección que aparece sea exactamente igual a la de tu ficha RUC de SUNAT. Confirma que los números de teléfono y correos electrónicos sean los correctos para tus clientes. # CÓMO EDITAR UNA SUCURSAL EXISTENTE (por web) Contexto: Modificar datos de una sede ya registrada. Dirígete a la sección de Ajustes y selecciona Configuración. Entra a la opción de Sucursales. Busca la sede que deseas cambiar y haz clic en el icono del lápiz azul (Editar). Actualiza la Dirección o los datos de Ubicación (distrito, provincia). Al finalizar, haz clic en el botón Guardar para aplicar los cambios. # CÓMO REGISTRAR UNA NUEVA EMPRESA (por web) Agregar una nueva entidad al sistema usando el RUC. Ingresa al módulo de Empresas desde el panel de control. Haz clic en el botón superior que dice Nuevo. Asegúrate de que el país seleccionado sea Perú. Escribe el número de RUC de la empresa en el campo correspondiente. Presiona el icono de la lupa para que el sistema complete automáticamente el nombre de la empresa. Revisa los datos y presiona el botón Guardar. # CÓMO OBTENER EL TOKEN DE TU EMPRESA (por web) Contexto: Obtener el código de seguridad para integraciones. Abre el menú principal en el lado izquierdo de tu pantalla. Busca y haz clic en la opción Token. Espera un momento a que aparezca el código en pantalla. Haz clic en el botón de copiar (el icono de hojas de papel) para guardarlo en tu portapapeles. # Los documentos que se pueden anular son: Facturas, boletas, notas de crédito Los documentos que no se pueden anular son:\ Guías de remisión remitente y transportista (desde un sistema externo, sin embargo se puede anular desde la misma sunat , accediendo con tu clave sol) se debe principalmente a las normas de validación de la SUNAT en Perú # Si Tienes problemas al consultar datos de DNI O RUC, Al ser un servicio o consulta directa de la sunat, nosotros no almacenamos la informacion, por lo cual puedes digitar manualmente el DNI, eso no impide el proceso de crear. Cuando pasa estos errores de obtener, DNI O RUC, se puede digitar manualmente hasta que el servicio de la SUNAT se restablezca # Estados \ Técnicamente y legalmente, la respuesta varía según el estado, pero la regla general en facturación electrónica es que solo se anula lo que existe legalmente. Aquí te detallo qué hacer en cada caso: Factura en estado "Rechazado" No se puede (ni se necesita) anular. Razón: Un documento rechazado por SUNAT no tiene validez legal. Es un comprobante "muerto". Para la SUNAT, esa factura nunca nació, por lo que no puedes anular algo que no existe en sus registros. Qué hacer en tu sistema: Si esta rechazado puede quedar asi o si esta registrado pero no tiene vaides en sunat, dejalo asi No debes intentar enviarle una Comunicación de Baja o una Nota de Crédito, ya que el sistema de SUNAT rechazará la anulación al no encontrar el documento previo como aceptado. Numeración: Ese correlativo ya no se puede volver a usar. Debes saltar al siguiente. Factura en estado "Registrado" No se anula ante SUNAT, se queda asi, pero aqui hay variables si esta registrado en el sistema y aceptado en sunat se podria tener validez, se tendria que verificar en sunat, buscando su correlativo y serie # Plazos de envío de facturas a la SUNAT \ Te recordamos que, para evitar inconvenientes con SUNAT, las boletas de venta deben enviarse a través de resúmenes masivos dentro de un plazo máximo de 7 días calendario. ¿Qué sucede si excedo este plazo?\ Aunque el sistema y la SUNAT pueden permitir el envío técnico después de los 7 días, el documento recibirá una observación tributaria. Legalmente, el envío fuera de plazo no está permitido, por lo que realizar esta acción queda bajo la responsabilidad y criterio del contribuyente. Te recomendamos regularizar tus envíos diariamente para mantener tu facturación libre de observaciones. ¿Qué hacer si una boleta en un resumen tiene errores? Si detectas que una boleta incluida en un resumen diario es incorrecta, el procedimiento consiste en excluir dicho comprobante y volver a generar el resumen. Identifica la boleta con el error. Elimínala o desactívala del lote de envío actual para que no sea procesada. Genera un nuevo resumen que contenga únicamente las boletas correctas. De esta manera, aseguras que la información enviada a SUNAT sea válida y evitas rechazos masivos de todo el paquete por culpa de un solo documento. # Mi factura figura como "Aceptada", pero no aparece en el portal de SUNAT Problema / Síntoma He emitido una factura hoy (o hace un par de días), el sistema indica estado "ACEPTADO", pero al consultar en el portal SOL de SUNAT o en la consulta pública, el comprobante no aparece o figura como "No existe". ¿Por qué sucede esto? Este es un comportamiento esperado debido a la latencia de actualización de los servidores de SUNAT. Desfase de Sincronización: El sistema de recepción de SUNAT (donde se valida el XML) es distinto al sistema de consulta visual. El primero es instantáneo, el segundo puede tardar entre 24 a 48 horas en actualizarse. Emisiones de Fin de Semana: Si emitiste el documento un viernes o sábado, es común que la visualización en el portal SOL se refleje recién el día lunes o martes. ¿Cómo acredito que la factura es válida? Para garantizar la validez legal frente a un cliente o una auditoría, cuentas con los siguientes respaldos: 1. El Archivo CDR (Constancia de Recepción): Es el único documento con valor legal que confirma que SUNAT recibió y aceptó el comprobante. Si el sistema te permite descargar el XML del CDR, ese es tu comprobante de éxito. 2. Consulta Integrada de Validez: No busques en "Mis Comprobantes" dentro de la clave SOL. Utiliza la \[Consulta Integrada de Validez de CPE] de libre acceso. Este servicio suele actualizarse más rápido que el historial del portal SOL. Acciones Recomendadas Descarga el CDR: Asegúrate de tener guardado el archivo XML de respuesta. Espera el tiempo de gracia: Si el documento fue emitido hoy, solicita a tu cliente que verifique la consulta pública pasadas las 24 horas. # Que tipos de empresa se puede registrar? Puedes crear empresas ya sea con RUC 10, 15 O 20 # regimen de empresas 1. Nuevo RUS (Régimen Único Simplificado) Este régimen está limitado a los consumidores finales. Emisión: Solo Boletas de Venta (físicas o electrónicas) y tickets. Restricción: NO pueden emitir Facturas. Nota importante: Si un cliente con RUC 20 le solicita una factura a un negocio en el RUS, este no podrá emitirla; de hacerlo, no tendrá validez tributaria para el comprador. 2. RER (Régimen Especial de Renta) Es el primer escalón para quienes necesitan emitir facturas de forma recurrente. Emisión: Facturas Electrónicas, Boletas, Notas de Crédito y Débito. Uso: Ideal para pequeñas empresas de comercio y servicios. 3. Régimen MYPE Tributario Diseñado para la formalización y crecimiento de las micro y pequeñas empresas. Emisión: Facturas Electrónicas, Boletas y cualquier otro comprobante complementario. Ventaja: Permite sustentar gastos y costos con facturas recibidas de proveedores, y emitirlas para clientes corporativos. 4. Régimen General Para empresas de cualquier tamaño sin límites de ingresos. Emisión: Facturas Electrónicas y toda la gama de comprobantes legales. Uso: Obligatorio para negocios que superen las 1,700 UIT de ingresos anuales. # Error 0111: No tiene el perfil \ El "Error 0111: No tiene el perfil para enviar comprobantes electrónicos" al enviar a SUNAT, a menudo denominado "Rejected by policy", ocurre principalmente por varias razones: Si usas el certificado PSE, puede ser que esto ya sea a nivel de SUNAT, del cual se queda esperar, recuerda también si activaste la firma pse debes de esperar 24 hrs, o mas esto ya es un tema de SUNAT, o incluso volver a repetir el proceso de dar de baja la firma, y volver activar la firma, ya que sunat no reconoce, si emitias sin problemas, y luego de dias o incluso meses enfrentas problemas puede ser todo relacionado a SUNAT, recuerda la SUNAT / OSE son quien valida los XML. En caso persiste indicanos para poderte ayudar a generar un ticket de seguimiento # Como configurar la integracion de shopify con factpro El proceso cubre desde la obtención de credenciales hasta la adaptación del *checkout* para capturar el documento de identidad. Video: 1. **Generar el Token de integración en Factpro:** 2. Ingresa al panel de administración de Factpro. 3. Asegúrate de tener tu empresa registrada en la plataforma. 4. Dirígete a la sección de **Integraciones** en el menú lateral. 5. Selecciona la tarjeta de **Shopify**. 6. Copia el **Factpro Token** que aparece en pantalla. 7. Recuerda que puedes convertir tus pedidos de forma manual o automático. 8. **Configurar las credenciales en la App de Shopify:** 9. En tu panel de Shopify, abre la aplicación de Factpro previamente instalada. 10. En el campo **Factpro API Versión**, selecciona la opción **Órdenes**. 11. Pega el token copiado en el campo **Factpro Token**. 12. En la sección "Configurar IGV en el precio de envío", marca **IGV Incluido** (recomendado). 13. Selecciona el **Formato de impresión** deseado (A4 o Ticket). 14. Guarda los cambios. 15. **Configurar los impuestos (IGV) en Shopify:** 16. Desde el panel principal de Shopify, ve a **Configuración** (esquina inferior izquierda). 17. Selecciona **Impuestos y aranceles**. 18. Activa la casilla **Incluir impuesto sobre las ventas en el precio del producto y la tarifa de envío** (asegurando que se aplique el 18%). 19. **Habilitar el campo de empresa en el Checkout:** 20. Regresa a **Configuración** y selecciona **Pago** (Checkout). 21. En la sección "Información del cliente", localiza el campo \*\*Nombre de la empresa \*\*. 22. Cambia su estado a **Opcional** u **Obligatorio**. *(Nota: Se recomienda "Obligatorio" si deseas que la conversión a factura electrónica con RUC se procese de manera 100% automática).* 23. **Personalizar la etiqueta del Checkout para el RUC/DNI:** 24. En la misma pantalla de **Pago**, haz scroll hasta la sección "Idioma de la pantalla de pago". 25. Haz clic en el botón **Editar contenido de la pantalla de pago**. 26. En la barra de búsqueda de la nueva pantalla, escribe `company`. 27. Desplázate hasta localizar el campo **Company label** (Checkout contact). 28. Reemplaza el texto predeterminado por una instrucción clara para tu cliente. Ejemplo: *"DIGITA SOLO TU NÚMERO DE RUC O DNI (PARA TU FACTURA)"*. > **Nota de entorno:** Toda cuenta nueva se genera en entorno **Demo** (los documentos no tienen validez fiscal ante SUNAT). para pasar a produccion me indicas si deseas para enviarte los pasos que seguiria video : # Unidades de medida (Universal) | 4A | BOBINAS | | --- | ------------------------ | | BE | FARDO | | BG | BOLSA | | BJ | BALDE | | BLL | BARRILES | | BO | BOTELLAS | | BX | CAJA | | C62 | PIEZAS | | CA | LATAS | | CEN | CIENTO DE UNIDADES | | CJ | CONOS | | CMK | CENTIMETRO CUADRADO | | CMQ | CENTIMETRO CUBICO | | CMT | CENTIMETRO LINEAL | | CT | CARTONES | | CY | CILINDRO | | DR | TAMBOR | | DZN | DOCENA | | DZP | DOCENA POR 10\*\*6 | | FOT | PIES | | FTK | PIES CUADRADOS | | FTQ | PIES CUBICOS | | GLI | GALON INGLES (4,545956L) | | GLL | US GALON (3,7843 L) | | GRM | GRAMO | | GRO | GRUESA | | HLT | HECTOLITRO | | INH | PULGADAS | | KGM | KILOGRAMO | | KT | KIT | | KTM | KILOMETRO | | KWH | KILOVATIO HORA | | LBR | LIBRAS | | LEF | HOJA | | LTN | TONELADA LARGA | | LTR | LITRO | | MGM | MILIGRAMOS | | MIL | MILLARES | | MLT | MILILITRO | | MMK | MILIMETRO CUADRADO | | MMQ | MILIMETRO CUBICO | | MMT | MILIMETRO | | MTK | METRO CUADRADO | | MTQ | METRO CUBICO | | MTR | METRO | | MWH | MEGAWATT HORA | | NIU | UNIDAD (BIENES) | | ONZ | ONZAS | | PF | PALETAS | | PG | PLACAS | | PK | PAQUETE | | PR | PAR | | RM | RESMA | | SET | JUEGO | | ST | PLIEGO | | STN | TONELADA CORTA | | TNE | TONELADAS | | TU | TUBOS | | UM | MILLON DE UNIDADES | | YDK | YARDA CUADRADA | | YRD | YARDA | | ZZ | UNIDAD (SERVICIOS) | # Estados de documentos | ID | Nombre | | -- | ------------------------------------------------------------------- | | 01 | Registrado en servidor factpro **(Se puede editar el comprobante)** | | 03 | Enviado pero sin respuesta de la sunat | | 05 | Aceptado ante la sunat | | 09 | Rechazado ante la sunat | | 11 | Anulado ante la sunat | | 13 | Por anular | | 19 | Sin respuesta de la sunat | # Catàlogos - SUNAT # Catálogo 05 - Código de tipos de tributos y otros conceptos Para nuestra versiòn 3 , deberàs usar la **columna** de **"CODIGO FACTPRO"**
Còdigo factproCódigo SunatDescripción
1027152Impuesto a la bolsa plastica
1032000ISC Impuesto Selectivo al Consumo
# Catálogo 06 - Tipo de documento de identidad Para nuestra versiòn 3 , deberàs usar la **columna** de **"CODIGO FACTPRO"**
Còdigo factproCódigo SunatDescripción
10DOC.TRIB.NO.DOM.SIN.RUC
21Documento Nacional de Identidad
34Carnet de extranjería
46Registro Unico de Contributentes
57Pasaporte
# Catálogo 07 - Impuestos Para nuestra versiòn 3 , deberàs usar la **columna** de **"CODIGO FACTPRO"**
Código FactproCódigo SunatPorcentajeSUNAT
11018%IGV
20200%Exonerado
21210%Exonerado - Transferencia gratuita
30300%Inafecto
40400%Exportación de Bienes o Servicios
1101010.5%IGV (Impuesto especial para restaurantes, hoteles y alojamientos turísticos. )
Nota: La tasa de **10.5%** de la SUNAT corresponde a un beneficio del IGV para las micro y pequeñas empresas (MYPE) del sector de **restaurantes, hoteles y alojamientos turísticos**. Esta tasa equivale al 8% de IGV más un 2.5% por el Impuesto de Promoción Municipal (IPM). # Catálogo 08 - Tipos de documentos Para nuestra versiòn 3 , deberàs usar la **columna** de **"CODIGO FACTPRO"**
Código factproCódigo SunatDescripción
701Factura
803Boleta de venta
907Nota de crédito
1008Nota de débito
1109Guía de remisión remitente
1231Guía de remisión transportista
1314Recibo servicios públicos
--- [Next Page](/llms-full.txt/1)