v1

latestOpenAPI 3.0.32026-07-24398641.3 MB
Numeraciones de facturación

Crear una numeración de facturación

Endpoint que permite crear una numeración de facturación en la cuenta de Alegra.

post/number-templates

Request body

namestring

Nombre de la numeración. Longitud máxima permitida: 45

prefixstring

Prefijo de la numeración. En perú, este parámetro es obligatorio si la numeración es electrónica y debe cumplir con las siguientes condiciones 1- Longitud de 4 caracteres. 2- Iniciar con la letra 'F'. Longitud máxima permitida: 100

nextInvoiceNumberinteger

Número final disponible para facturar. Longitud máxima permitida: 11.

isDefaultboolean

Indica si es la numeración preferida.

autoincrementboolean

Indica si la numeración es automática..

invoiceTextstring

Texto de la factura

documentTypestring

Tipo de documento

Example request

{
  "name": "Nueva numeración",
  "prefix": "F001",
  "nextInvoiceNumber": 1,
  "isDefault": true,
  "autoincrement": true,
  "invoiceText": "Factura electrónica",
  "documentType": "invoice"
}

Response

Retorna información de una numeración de facturación

idstring

ID de la numeración

namestring

Nombre de la numeración

prefixstring nullable

Prefijo de la numeración

maxInvoiceNumberinteger nullable

Número máximo de facturación

invoiceTextstring nullable

Texto de la factura

isDefaultboolean

Indica si es la numeración preferida

status'active' | 'inactive'

Estado de la numeración

autoincrementboolean

Indica si la numeración es automática

documentTypestring

Tipo de documento

deletableboolean

Indica si la numeración se puede eliminar

nextInvoiceNumberinteger

Siguiente número de factura

startDatestring date

Fecha de inicio de la numeración

endDatestring date

Fecha de fin de la numeración

resolutionNumberstring

Número de resolución

minInvoiceNumberinteger

Número mínimo de facturación

isElectronicboolean

Indica si la numeración es electrónica

Example response

{
  "id": "1",
  "name": "Principal",
  "maxInvoiceNumber": 1000,
  "isDefault": true,
  "status": "active",
  "autoincrement": true,
  "documentType": "invoice",
  "nextInvoiceNumber": 125,
  "startDate": "2025-01-01",
  "endDate": "2025-12-31",
  "resolutionNumber": "1234567890",
  "minInvoiceNumber": 1,
  "isElectronic": true
}