Create Invoice

Create Invoice

curl --request POST \
  --url https://api.example.com/api/v1/invoices \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_id": 123,
  "branch_id": 123,
  "serie": "<string>",
  "fecha_emision": "<string>",
  "fecha_vencimiento": "<string>",
  "moneda": "<string>",
  "tipo_operacion": "<string>",
  "forma_pago_tipo": "<string>",
  "forma_pago_cuotas": [
    {
      "forma_pago_cuotas[].moneda": "<string>",
      "forma_pago_cuotas[].monto": 123,
      "forma_pago_cuotas[].fecha_pago": "<string>"
    }
  ],
  "client": {
    "client.tipo_documento": "<string>",
    "client.numero_documento": "<string>",
    "client.razon_social": "<string>",
    "client.nombre_comercial": "<string>",
    "client.direccion": "<string>",
    "client.ubigeo": "<string>",
    "client.distrito": "<string>",
    "client.provincia": "<string>",
    "client.departamento": "<string>",
    "client.telefono": "<string>",
    "client.email": {}
  },
  "detalles": [
    {
      "detalles[].codigo": "<string>",
      "detalles[].descripcion": "<string>",
      "detalles[].unidad": "<string>",
      "detalles[].cantidad": 123,
      "detalles[].mto_valor_unitario": 123,
      "detalles[].porcentaje_igv": 123,
      "detalles[].porcentaje_ivap": 123,
      "detalles[].mto_valor_gratuito": 123,
      "detalles[].tip_afe_igv": "<string>",
      "detalles[].codigo_producto_sunat": "<string>"
    }
  ],
  "detraccion": {
    "detraccion.codigo_bien_servicio": "<string>",
    "detraccion.codigo_medio_pago": "<string>",
    "detraccion.cuenta_banco": "<string>",
    "detraccion.porcentaje": 123,
    "detraccion.monto": 123
  },
  "percepcion": {
    "percepcion.cod_regimen": "<string>",
    "percepcion.tasa": 123,
    "percepcion.monto": 123,
    "percepcion.monto_base": 123,
    "percepcion.monto_total": 123
  },
  "retencion": {
    "retencion.cod_regimen": "<string>",
    "retencion.tasa": 123,
    "retencion.monto": 123,
    "retencion.monto_base": 123,
    "retencion.monto_total": 123
  },
  "guias": [
    {}
  ],
  "documentos_relacionados": [
    {}
  ],
  "datos_adicionales": [
    {}
  ],
  "usuario_creacion": "<string>"
}
'

{
  "success": true,
  "data": {
    "id": 123,
    "company_id": 123,
    "branch_id": 123,
    "serie": "<string>",
    "numero": 123,
    "numero_completo": "<string>",
    "fecha_emision": "<string>",
    "estado_sunat": "<string>",
    "company": {},
    "branch": {},
    "client": {}
  },
  "message": "<string>"
}

POST

api

invoices

Create Invoice

curl --request POST \
  --url https://api.example.com/api/v1/invoices \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_id": 123,
  "branch_id": 123,
  "serie": "<string>",
  "fecha_emision": "<string>",
  "fecha_vencimiento": "<string>",
  "moneda": "<string>",
  "tipo_operacion": "<string>",
  "forma_pago_tipo": "<string>",
  "forma_pago_cuotas": [
    {
      "forma_pago_cuotas[].moneda": "<string>",
      "forma_pago_cuotas[].monto": 123,
      "forma_pago_cuotas[].fecha_pago": "<string>"
    }
  ],
  "client": {
    "client.tipo_documento": "<string>",
    "client.numero_documento": "<string>",
    "client.razon_social": "<string>",
    "client.nombre_comercial": "<string>",
    "client.direccion": "<string>",
    "client.ubigeo": "<string>",
    "client.distrito": "<string>",
    "client.provincia": "<string>",
    "client.departamento": "<string>",
    "client.telefono": "<string>",
    "client.email": {}
  },
  "detalles": [
    {
      "detalles[].codigo": "<string>",
      "detalles[].descripcion": "<string>",
      "detalles[].unidad": "<string>",
      "detalles[].cantidad": 123,
      "detalles[].mto_valor_unitario": 123,
      "detalles[].porcentaje_igv": 123,
      "detalles[].porcentaje_ivap": 123,
      "detalles[].mto_valor_gratuito": 123,
      "detalles[].tip_afe_igv": "<string>",
      "detalles[].codigo_producto_sunat": "<string>"
    }
  ],
  "detraccion": {
    "detraccion.codigo_bien_servicio": "<string>",
    "detraccion.codigo_medio_pago": "<string>",
    "detraccion.cuenta_banco": "<string>",
    "detraccion.porcentaje": 123,
    "detraccion.monto": 123
  },
  "percepcion": {
    "percepcion.cod_regimen": "<string>",
    "percepcion.tasa": 123,
    "percepcion.monto": 123,
    "percepcion.monto_base": 123,
    "percepcion.monto_total": 123
  },
  "retencion": {
    "retencion.cod_regimen": "<string>",
    "retencion.tasa": 123,
    "retencion.monto": 123,
    "retencion.monto_base": 123,
    "retencion.monto_total": 123
  },
  "guias": [
    {}
  ],
  "documentos_relacionados": [
    {}
  ],
  "datos_adicionales": [
    {}
  ],
  "usuario_creacion": "<string>"
}
'

{
  "success": true,
  "data": {
    "id": 123,
    "company_id": 123,
    "branch_id": 123,
    "serie": "<string>",
    "numero": 123,
    "numero_completo": "<string>",
    "fecha_emision": "<string>",
    "estado_sunat": "<string>",
    "company": {},
    "branch": {},
    "client": {}
  },
  "message": "<string>"
}

Creates a new electronic invoice (Factura) for SUNAT. The invoice is created in draft status and must be sent to SUNAT separately.

Facturas are issued to business customers (RUC) and support advanced features like credit terms, detraction, perception, and retention.

Authentication

This endpoint requires authentication using a Bearer token (Sanctum).

Authorization: Bearer YOUR_API_TOKEN

Request Body

Company and Branch

company_id

integer

required

ID of the company issuing the invoice. Must exist in the companies table.

branch_id

integer

required

ID of the branch issuing the invoice. Must belong to the specified company.

serie

string

required

Invoice series code (max 4 characters). Must start with ‘F’ for facturas (e.g., “F001”).

Dates and Currency

fecha_emision

date

required

Invoice issue date in YYYY-MM-DD format.

fecha_vencimiento

date

Due date for the invoice. Must be equal to or after the issue date. Required for credit invoices.

moneda

string

required

Currency code. Allowed values: PEN (Peruvian Sol), USD (US Dollar).

tipo_operacion

string

Type of operation code (max 4 characters).

0101: Internal sale (default)
0200: Export
0112: Sale with IVAP
Other SUNAT catalog 51 codes

Payment Terms

forma_pago_tipo

string

required

Payment type. Allowed values: Contado (cash), Credito (credit).

forma_pago_cuotas

array

Payment installments. Required when forma_pago_tipo is Credito.

Show Installment object

forma_pago_cuotas[].moneda

string

required

Currency of the installment.

forma_pago_cuotas[].monto

number

required

Installment amount (min: 0).

forma_pago_cuotas[].fecha_pago

date

required

Installment payment date.

Client Information

client

object

required

Customer information.

Show Client object

client.tipo_documento

string

required

Document type code:

1: DNI (National ID)
4: Carnet de extranjería
6: RUC (Tax ID)
0: Other

client.numero_documento

string

required

Document number (max 15 characters).

Legal name or business name (max 255 characters).

client.nombre_comercial

string

Trade name (max 255 characters).

client.direccion

string

Address (max 255 characters).

client.ubigeo

string

UBIGEO code (6 digits). Geographic location code.

client.distrito

string

District name (max 100 characters).

client.provincia

string

Province name (max 100 characters).

client.departamento

string

Department name (max 100 characters).

client.telefono

string

Phone number (max 20 characters).

client.email

Email address (max 100 characters).

Invoice Items

detalles

array

required

Invoice line items (minimum 1 item required).

Show Item object

detalles[].codigo

string

required

Product/service code (max 50 characters).

detalles[].descripcion

string

required

Item description (max 500 characters).

detalles[].unidad

string

required

Unit of measure code (max 3 characters). Examples: NIU (unit), ZZ (service).

detalles[].cantidad

number

required

Quantity (min: 0.001).

detalles[].mto_valor_unitario

number

required

Unit value excluding taxes (min: 0).

detalles[].porcentaje_igv

number

IGV (VAT) percentage. Typically 18. Not used for exports.

detalles[].porcentaje_ivap

number

IVAP percentage for rice sales (0-100).

detalles[].mto_valor_gratuito

number

Free item value (min: 0). For promotional items.

detalles[].tip_afe_igv

string

IGV affectation type code:

10: Taxable - Onerosa Operation
11: Taxable - Free Withdrawal
12: Taxable - Withdrawal by Prize
13: Taxable - Donation
14: Taxable - Promotion
15: Taxable - Consumed Himself
16: Taxable - Other Free
17: Taxable - IVAP
20: Exempt - IGV/IVAP Transfer
21: Exempt - Free Transfer
30: Non-Taxable - Onerosa Operation
31: Non-Taxable - Free Withdrawal
32: Non-Taxable - Withdrawal by Prize
33: Non-Taxable - Donation
34: Non-Taxable - Others
35: Non-Taxable - Sale Service
36: Non-Taxable - Not Domiciled
40: Export

detalles[].codigo_producto_sunat

string

SUNAT product code (max 50 characters).

Detraction (Optional)

detraccion

object

Detraction information for applicable services/goods.

Show Detraction object

detraccion.codigo_bien_servicio

string

required

Service/good code subject to detraction (max 3 characters).

detraccion.codigo_medio_pago

string

Payment method code (max 3 characters).

detraccion.cuenta_banco

string

Bank account for detraction (max 20 characters).

detraccion.porcentaje

number

required

Detraction percentage (0-100).

detraccion.monto

number

Detraction amount (min: 0).

Perception (Optional)

percepcion

object

Perception information for applicable transactions.

Show Perception object

percepcion.cod_regimen

string

required

Perception regime code (max 2 characters).

percepcion.tasa

number

required

Perception rate (0-100).

percepcion.monto

number

required

Perception amount (min: 0).

percepcion.monto_base

number

required

Base amount for perception (min: 0).

percepcion.monto_total

number

required

Total amount including perception (min: 0).

Retention (Optional)

retencion

object

Retention information for applicable transactions.

Show Retention object

retencion.cod_regimen

string

required

Retention regime code (max 2 characters).

retencion.tasa

number

required

Retention rate (0-100).

retencion.monto

number

required

Retention amount (min: 0).

retencion.monto_base

number

required

Base amount for retention (min: 0).

retencion.monto_total

number

required

Total amount including retention (min: 0).

Additional Data (Optional)

guias

array

Related shipping guides.

documentos_relacionados

array

Response

success

boolean

Indicates if the invoice was created successfully.

data

object

The created invoice object with relationships.

Show Invoice object

integer

Invoice ID.

company_id

integer

Company ID.

branch_id

integer

Branch ID.

serie

string

Invoice series.

numero

integer

Invoice sequential number.

numero_completo

string

Full invoice number (serie-numero).

fecha_emision

date

Issue date.

estado_sunat

string

SUNAT status: PENDIENTE, ACEPTADO, RECHAZADO.

company

object

Company information.

branch

object

Branch information.

client

object

Client information.

message

string

Success message.

Request Example

curl -X POST https://api.example.com/api/v1/invoices \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "company_id": 1,
    "branch_id": 1,
    "serie": "F001",
    "fecha_emision": "2024-03-15",
    "fecha_vencimiento": "2024-04-15",
    "moneda": "PEN",
    "tipo_operacion": "0101",
    "forma_pago_tipo": "Credito",
    "forma_pago_cuotas": [
      {
        "moneda": "PEN",
        "monto": 590.00,
        "fecha_pago": "2024-04-15"
      }
    ],
    "client": {
      "tipo_documento": "6",
      "numero_documento": "20123456789",
      "razon_social": "EMPRESA DEMO SAC",
      "direccion": "AV. PRINCIPAL 123",
      "ubigeo": "150101",
      "distrito": "LIMA",
      "provincia": "LIMA",
      "departamento": "LIMA",
      "telefono": "01-1234567",
      "email": "[email protected]"
    },
    "detalles": [
      {
        "codigo": "PROD001",
        "descripcion": "SERVICIO DE CONSULTORIA",
        "unidad": "ZZ",
        "cantidad": 1,
        "mto_valor_unitario": 500.00,
        "porcentaje_igv": 18,
        "tip_afe_igv": "10"
      }
    ],
    "usuario_creacion": "admin"
  }'

Response Example

{
  "success": true,
  "data": {
    "id": 123,
    "company_id": 1,
    "branch_id": 1,
    "serie": "F001",
    "numero": 456,
    "numero_completo": "F001-456",
    "fecha_emision": "2024-03-15",
    "fecha_vencimiento": "2024-04-15",
    "moneda": "PEN",
    "tipo_operacion": "0101",
    "estado_sunat": "PENDIENTE",
    "mto_oper_gravadas": 500.00,
    "mto_igv": 90.00,
    "mto_imp_venta": 590.00,
    "forma_pago_tipo": "Credito",
    "created_at": "2024-03-15T10:30:00.000000Z",
    "updated_at": "2024-03-15T10:30:00.000000Z",
    "company": {
      "id": 1,
      "ruc": "20987654321",
      "razon_social": "MI EMPRESA SAC"
    },
    "branch": {
      "id": 1,
      "nombre": "Sede Principal",
      "codigo": "0000"
    },
    "client": {
      "id": 45,
      "tipo_documento": "6",
      "numero_documento": "20123456789",
      "razon_social": "EMPRESA DEMO SAC"
    }
  },
  "message": "Factura creada correctamente"
}

The invoice is created in PENDIENTE (pending) status. You must call the Send to SUNAT endpoint to submit it for validation.

Tax Calculation

The API automatically calculates taxes based on the item details:

Base IGV: Calculated from mto_valor_unitario × cantidad for taxable items
IGV Amount: Base × (porcentaje_igv / 100)
Unit Price: (Value + IGV) / quantity
Export Operations (tipo_operacion: 0200): IGV is set to 0, and tip_afe_igv is set to 40

List Invoices

Get Invoice

⌘I

Build docs developers (and LLMs) love

Get started for free Talk to us

Authentication

Companies & Branches

Clients

Electronic Documents

Consultations

Configuration

Authentication

Request Body

Company and Branch

Dates and Currency

Payment Terms

Client Information

Invoice Items

Detraction (Optional)

Perception (Optional)

Retention (Optional)

Additional Data (Optional)

Response

Request Example

Response Example

Tax Calculation

Build docs developers (and LLMs) love

Authentication

Companies & Branches

Clients

Electronic Documents

Consultations

Configuration

​Authentication

​Request Body

​Company and Branch

​Dates and Currency

​Payment Terms

​Client Information

​Invoice Items

​Detraction (Optional)

​Perception (Optional)

​Retention (Optional)

​Additional Data (Optional)

​Response

​Request Example

​Response Example

​Tax Calculation

​Related Endpoints

Build docs developers (and LLMs) love

Authentication

Request Body

Company and Branch

Dates and Currency

Payment Terms

Client Information

Invoice Items

Detraction (Optional)

Perception (Optional)

Retention (Optional)

Additional Data (Optional)

Response

Request Example

Response Example

Tax Calculation

Related Endpoints