Descripción general

Endpoint /number-templates

Los usuarios pueden registrar en la aplicación diferentes numeraciones o folios para facturar. Para saber más información sobre la configuración de numeraciones haz clic aquí.

Este recurso está definido en el API comonumber-template y se puede consultar para asociar las facturas nuevas a diferentes numeraciones.

Se debe tener en cuenta que en la creación de facturas, si no se envía el parámetro numberTemplate, la aplicación asociará la factura de venta a la numeración que se tenga como preferida siempre y cuando esta numeración esté configurada como automática (haz clic aquí para saber más) y le asignará el siguiente número de facturación que corresponda.

Una numeración (numberTemplate) contiene los siguientes atributos:

Nombre

Tipo

Descripción

Ejemplo

id

Integer

Identificador único que representa una numeración específica. La aplicación lo asigna automáticamente.

1

name

String

Nombre con el cual está identificada la numeración.

Almacén Oriente

prefix

String

Prefijo asociado a la numeración. Las facturas creadas con esta numeración se les asignará automáticamente el prefijo indicado.

AL-

nextInvoiceNumber

Integer

Siguiente número disponible para facturar. Este atributo solo se popula cuando la numeración esta configurada como automática.

150

maxInvoiceNumber

Integer

Número final para facturar.
Este atributo solo se popula cuando la numeración esta configurada como automática.

300

invoiceText

String

Texto de la numeración. En versión Alegra Colombia este atributo equivale a la resolución de facturación de la factura de venta.

Resolución de la DIAN # 45112

isDefault

Boolean

Indica si la numeración es la preferida. Sólo puede existir una numeración como preferida.

true

status

Estado de la numeración. Puede ser active o inactive. Las numeraciones inactivas no pueden ser utilizadas en la creación de facturas de venta.

active

autoincrement

Boolean

Indica si la numeración incrementa automáticamente o se debe indicar el número de la factura.

true

isElectronic

Boolean

Indica si la numeración es electrónica.

true

documentType

String

Indica el tipo de documento de la numeración, los valores posibles son:

General:

  • "invoice" (Factura de venta)

Republica Dominicana:

  • "transactonIn" (Recibo de caja)
  • "transactionOut" (Comprobante de egreso)
  • "creditNote" (Nota crédito)
  • "debitNote" (Nota débito)
  • "remission" (Remisión)
  • "purchaseOrder" (Orden de compra)
  • "estimate" (Cotización)

Perú:

  • "invoice" (Factura de venta)
  • "saleTicket" (Boleta de venta)

Colombia:

  • "invoice" (Factura de venta)
  • "saleTicket" (Documento equivalente P.O.S.)
  • "supportDocument" (Documento soporte)

Costa Rica:

  • "provisionalDocument" (Factura de contingencia)

invoice

branchOffice (Republica Dominicana)

String

Indica la sucursal asociada a la numeración.

Este campo es exclusivo para numeraciones de facturas (invoice) y notas crédito (creditNote).

Principal

branchOfficeCode (Panamá)

String

Indica el código de sucursal asociado a la numeración.

Este campo es exclusivo para numeraciones electrónicas de facturas (invoice) y notas crédito (creditNote).

0001

startDate

String. Formato yyyy-MM-dd

Para la versión de Republica Dominicana y Colombia.

Fecha de inicio de la resolución que autoriza la numeración.

Este campo es exclusivo para numeraciones de facturas (invoice).

2018-02-02

endDate

String. Formato yyyy-MM-dd

Para la versión de Republica Dominicana y Colombia.

Fecha final de la resolución que autoriza la numeración.

Este campo es exclusivo para numeraciones de facturas (invoice).

2018-02-03

resolutionNumber (Colombia)

Integer

Para la versión de Colombia.

Indica el número de resolución que autoriza la numeración.

subDocumentType

String

Para la versión de Chile, Costa Rica, Argentina y Republica Dominicana.

Actualmente se usa para invoice (actualmente factura de venta y boletas para Chile, para Costa Rica facutras de venta, para Argentina factura de venta, nota crédito, nota débito y presupuesto y para Rep. Dominicana en factura de venta, nota crédito, nota débito, pagos y gastos) . Indica un tipo de factura, por ejemplo: factura exenta. Para modificar el tipo de factura a factura de venta, se debe enviar el parámetro vació ("") o si se envía un valor inexistente, se tomará como factura de venta.

Consulta el listado de valores para subDocumentType en Chile, Costa Rica, Argentina y [República Dominicana (https://developer.alegra.com/docs/república-dominicana)

EXEMPT_INVOICE

📘

Versión Alegra Perú

Para Perú, si la numeración es electrónica, el atributo "prefix" es obligatorio y debe cumplir con las siguientes reglas.

  • Longitud de 4 caracteres.
  • Iniciar con la letra "F" en mayúscula.