✌️
Factpro API
  • APIs de cumplimiento tributario
  • API facturación
    • Crear una cuenta
      • Recorrido de las funciones de la WEB API
    • ✔️Configuración de empresa
      • Crear empresas
      • Actualizar datos de empresa
      • Cambiar color PDF
      • Logo
      • Crear sede
      • Listar sedes
      • Editar sede
      • Nueva serie
      • Eliminar sede
      • Listar series
      • Eliminar serie
    • ☑️Estructura para generar comprobantes
      • Factura contado
      • Factura Gravada - crédito
      • Boleta Gravada
      • Nota de Crédito a Factura
      • Nota de Débito a Factura
      • Factura Exonerado - Operación Onerosa
      • Factura con Detracción
      • Factura Exportación- Bienes
      • Factura Gratuita: Exonerado Transferencia Gratuita
      • Factura con descuento Global
    • ✅Estructura GRE - Remitente
      • Guía de Remisión - Remitente
    • ✅Estructura GRE - Transportista
      • Ejemplo de Guía de Remisión - Transportista: Estándar
      • Ejemplo de Guía de Remisión - Transportista : Documentos y conductores secundarios
    • Consultar estados
    • Envío de boletas por Resumen
    • Consultar ticket
    • Anular Boletas
    • Anular Facturas
      • Consultar ticket de anulación
    • Estructura Detracción
Con tecnología de GitBook
En esta página
  1. API facturación

Estructura para generar comprobantes

-

ATRIBUTO
VALOR
REQUISITO
LONGUITUD

serie_documento

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.

Obligatorio

4 exacto

numero_documento

Número correlativo del documento

Obligatorio

1 hasta 8

fecha_de_emision

Debe ser la fecha actual. Ejemplo: 2024-05-14

Obligatorio

10 exacto

hora_de_emision

Debe ser la hora actual 10:11:11

Opcional

codigo_tipo_operacion

En todos los casos se utiliza por defecto: 0101

0101 = VENTA INTERNA

0200 = EXPORTACIÓN

1001 = Operación Sujeta a Detracción

Obligatorio

4 exacto

codigo_tipo_documento

Tipo de COMPROBANTE :

01 = FACTURA ELECTRÓNICA

03 = BOLETA DE VENTA ELECTRÓNICA

07 = NOTA DE CRÉDITO

08 = NOTA DE DÉBITO

Obligatorio

2 exacto

codigo_tipo_moneda

PEN = SOLES

USD= DÓLARES

Obligatorio

3 exacto

fecha_de_vencimiento

Ejemplo: 2024-05-14

Opcional

10 exacto

numero_orden_de_compra

Texto de 0 hasta 1000 caracteres.

Opcional

enviar_automaticamente_al_cliente

Dirección de email false = No se enviara true = Se enviará automáticamente

Opcional

DATOS DEL EMISOR

codigo_del_domicilio_fiscal

Cada establecimiento cuenta con un código de anexo, por ejemplo la oficina principal es 0000

Obligatorio

4 exacto

DATOS DEL CLIENTE

codigo_tipo_documento_identidad

6 = RUC - REGISTRO ÚNICO DE CONTRIBUYENTE

1 = DNI - DOC. NACIONAL DE IDENTIDAD

4 = CARNET DE EXTRANJERÍA

7 = PASAPORTE

A = CÉDULA DIPLOMÁTICA DE IDENTIDAD

0 = NO DOMICILIADO, SIN RUC

Obligatorio

1 exacto

numero_documento

Ejemplo: RUC del CLIENTE, número de DNI, Etc.

Obligatorio

1 hasta 15

apellidos_y_nombres_o_razon_social

Razón o nombre completo del CLIENTE.

Obligatorio

1 hasta 100

codigo_pais

Colocar el país del CLIENTE, por ejemplo Perú = PE

Opcional

2 exacto

ubigeo

Debe ingresar número por código de Ubigeo , por ejemplo 150101

Opcional

2 exacto

direccion

Dirección completa (OPCIONAL en caso de ser una BOLETA DE VENTA o NOTA ASOCIADA).

Condicional

1 hasta 100

correo_electronico

Correo referencial

Opcional

telefono

Teléfono referencial

Opcional

TOTALES

total_operaciones_gravadas

0.00

Condicional

1 hasta 12 enteros con 2 decimales

total_operaciones_inafectas

0.00

Condicional

1 hasta 12 enteros con 2 decimales

total_operaciones_exoneradas

0.00

Condicional

1 hasta 12 enteros con 2 decimales

total_operaciones_gratuitas

0.00

Condicional

1 hasta 12 enteros con 2 decimales

total_igv

18

Condicional

1 hasta 12 enteros con 2 decimales

total_impuestos

18

Condicional

1 hasta 12 enteros con 2 decimales

total_valor

0.00

Condicional

1 hasta 12 enteros con 2 decimales

total_venta

0.00

Condicional

1 hasta 12 enteros con 2 decimales

ITEMS

codigo_interno

Opcional, código interno del producto por ejemplo P0121

Opcional

1 hasta 250

descripcion

Nombre del producto

Obligatorio

1 hasta 250

codigo_producto_sunat

Opcional

Hasta 8

codigo_producto_gsl

Opcional

unidad_de_medida

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

NIU = PRODUCTO

ZZ = SERVICIO

Obligatorio

2 hasta 5

cantidad

Ejemplo: 10.00

Obligatorio

1 hasta 12 enteros, hasta con 10 decimales

valor_unitario

Sin IGV. Ejemplo: 50

1 hasta 12 enteros, hasta con 10 decimales

codigo_tipo_precio

Enviar el código

01 = Precio unitario (incluye el IGV)

02 = Valor referencial unitario en operaciones no onerosas

Obligatorio

2 exacto

precio_unitario

Con IGV. Ejemplo: 59

Obligatorio

1 hasta 12 enteros, hasta con 10 decimales

codigo_tipo_afectacion_igv

10 = Gravado - Operación Onerosa

11 = Gravado – Retiro por premio

12 = Gravado – Retiro por donación

13 = Gravado – Retiro

14 = Gravado – Retiro por publicidad

15 = Gravado – Bonificaciones

16 = Gravado – Retiro por entrega a trabajadores

20= Exonerado - Operación Onerosa

21= Exonerado - Transferencia Gratuita

30= Inafecto - Operación Onerosa

31= Inafecto – Retiro por Bonificación

32= Inafecto – Retiro

33= Inafecto – Retiro por Muestras Médicas

34= Inafecto - Retiro por Convenio Colectivo

35= Inafecto – Retiro por premio

36= Inafecto - Retiro por publicidad

40= Exportación

Obligatorio

2 exacto

total_base_igv

100

Obligatorio

1 hasta 12 enteros con 2 decimales

porcentaje_igv

18

Obligatorio

1 hasta 12 enteros con 2 decimales

total_igv

18

Obligatorio

1 hasta 12 enteros con 2 decimales

total_impuestos

18

Obligatorio

1 hasta 12 enteros con 2 decimales

total_valor_item

100

Obligatorio

1 hasta 12 enteros con 2 decimales

total_item

118

Obligatorio

1 hasta 12 enteros con 2 decimales

formato_pdf

Puedes elegir entre a4 o ticket para mostrar automáticamente el formato del PDF

Obligatorio

additional_information

Texto de 0 hasta 1000 caracteres.

Opcional

CONDICIÓN DE PAGO

descripcion

Deberás indicas si es Contado o Crédito

Condicional

7 exacto

tipo

0= Contado y 1 = Crédito

Condicional

1 exacto

cuota

Solo aplica si es a crédito

La estructura del nombre de la cuota es: Cuota001 , si tienes mas de una cuota Cuota002 , Cuota003 ...

Condicional

8 exacto

fecha_de_pago

Solo aplica si es a crédito tendrán un formato: 2024-01-03

Condicional

10 exacto

importe

Solo aplica si es a crédito debe ir el monto de la cuota, ejemplo 50.00

Condicional

1 hasta 12 enteros con 2 decimales

AnteriorEliminar serieSiguienteFactura contado

Última actualización hace 1 año

☑️