☑️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 0401 = Ventas no domiciliados que no califican como exportación

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

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

Última actualización