☑️Estructura para generar comprobantes

POSThttps://dev.factpro.la/api/v2/documentos

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

ATRIBUTO	VALOR	REQUISITO	LONGUITUD
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
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.	Obligatorio	4 exacto
numero	Número correlativo del documento	Obligatorio	1 hasta 8
tipo_operacion	En todos los casos se utiliza por defecto: 0101 0101 = VENTA INTERNA 0200 = EXPORTACIÓN 1001 = Operación Sujeta a Detracción 1004 = Operación Sujeta a Detracción- Servicios de Transporte Carga	Obligatorio	4 exacto
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
moneda	PEN = SOLES USD= DÓLARES	Obligatorio	3 exacto
porcentaje_de_venta	Es el porcentaje a la venta Perú / IGV : 18% y 10% Ejemplo: 18	Obligatorio	2 enteros
fecha_de_vencimiento	Ejemplo: 2024-05-14	Opcional	10 exacto
enviar_automaticamente_al_cliente	Dirección de email false = No se enviara true = Se enviará automáticamente	Opcional
DATOS DEL EMISOR
codigo_establecimiento	Cada establecimiento cuenta con un código de anexo, por ejemplo la oficina principal es 0000	Obligatorio	4 exacto
DATOS DEL CLIENTE
cliente_tipo_documento	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
cliente_numero_documento	Ejemplo: RUC del CLIENTE, número de DNI, Etc.	Obligatorio	1 hasta 15
cliente_denomiacion	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
cliente_direccion	Dirección completa (OPCIONAL en caso de ser una BOLETA DE VENTA o NOTA ASOCIADA).	Condicional	1 hasta 100
cliente_email	Correo referencial	Opcional
cliente_telefono	Teléfono referencial	Opcional
TOTALES
total_exportacion		Condicional	1 hasta 12 enteros con 2 decimales
total_gravadas		Condicional	1 hasta 12 enteros con 2 decimales
total_inafectas	0.00	Condicional	1 hasta 12 enteros con 2 decimales
total_exoneradas	0.00	Condicional	1 hasta 12 enteros con 2 decimales
total_gratuitas	0.00	Condicional	1 hasta 12 enteros con 2 decimales
tota_otros_cargos	0.00	Condicional	1 hasta 12 enteros con 2 decimales
total_tax	18	Condicional	1 hasta 12 enteros con 2 decimales
total_venta	118.00	Condicional	1 hasta 12 enteros con 2 decimales
total_retencion	0.0	Condicional	1 hasta 12 enteros con 2 decimales
código_retencion	"01" = tasa 3% "02" = tasa 6%	Condicional	2 exacto
ITEMS
unidad	Enviar las unidades de medida, por ejemplo para Unidad es = NIU NIU = PRODUCTO ZZ = SERVICIO	Obligatorio	2 hasta 5
codigo	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
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
precio_unitario	Con IGV. Ejemplo: 59	Obligatorio	1 hasta 12 enteros, hasta con 10 decimales
tipo_tax	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_tax	100	Obligatorio	1 hasta 12 enteros con 2 decimales
total_tax	18	Obligatorio	1 hasta 12 enteros con 2 decimales
total	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
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
forma_de_pago	Texto de 0 hasta 1000 caracteres.	Opcional
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

{
  "tipo_documento": "01",
  "serie": "F001",
  "numero": "#",
  "tipo_operacion": "0101",
  "fecha_de_emision": "2024-06-25",
  "hora_de_emision": "",
  "moneda": "PEN",
  "porcentaje_de_venta": 18.00,
  "fecha_de_vencimiento": "",
  "enviar_automaticamente_al_cliente": true,
  "datos_del_emisor": {
    "codigo_establecimiento": "0000"
  },
  "cliente": {
    "cliente_tipo_documento": "6",
    "cliente_numero_documento": "20605577246",
    "cliente_denominacion": "CORPORACION VEL PERU S.A.C.",
    "codigo_pais": "",
    "ubigeo": "",
    "cliente_direccion": "Av.",
    "cliente_email": "",
    "cliente_telefono": ""
  },
  "totales": {
    "total_exportacion": 0.00,
    "total_gravadas": 100.00,
    "total_inafectas": 0.00,
    "total_exoneradas": 0.00,
    "total_gratuitas": 0.00,
    "total_tax": 18.00,
    "total_venta": 118
  },
  "items": [
    {
      "unidad": "NIU",
      "codigo": "",
      "descripcion": "MacbookPro",
      "codigo_producto_sunat": "",
      "codigo_producto_gsl": "",
      "cantidad": 1,
      "valor_unitario": 100,
      "precio_unitario": 118,
      "tipo_tax": "10",
      "total_base_tax": 100.00,
      "total_tax": 18,
      "total": 118
      }
  ],
  "acciones": {
    "formato_pdf": "a4"
  },
  "termino_de_pago": {
    "descripcion": "Contado",
    "tipo": "0"
  },
  "metodo_de_pago": "",
  "canal_de_venta": "",
  "orden_de_compra": "",
  "almacen": "",
  "observaciones": ""
}

Response

200

{
    "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": []
    }
}