Referencia del SDK

Crear la URL del comprobante

Factumono.createVoucherUrl(params) devuelve la URL, o tira ValidationError si no se puede armar. La URL comprime los datos para permitir enviar más información y el formulario los lee para completar los campos, los campos omitidos se completan con los valores por default.

import { Factumono, ValidationError, VoucherType } from "@factumono/sdk";

try {
  const url = Factumono.createVoucherUrl({
    type: VoucherType.FacturaC,
    items: [{ description: "Bananas premium", unitPrice: 10000 }],
  });
} catch (error) {
  if (error instanceof ValidationError) {
    console.error(error.errors);
  }
}

`params`

Nombre	Tipo	Requerido	Default	Descripción
`type`	`VoucherType`	✅	—	Tipo de comprobante Factura C, etc.
`taxId`	`string \| number`	❌	El CUIT en uso	El CUIT del emisor del comprobante, si el usuario tiene uno solo en Factumono se puede omitir.
`items`	`Item[]`	✅	—	El detalle de los productos o servicios a facturar, hasta 50 items.
`customer`	`Customer`	❌	—	El receptor del comprobante. Podés omitirlo si es Consumidor Final.
`concept`	`Concept`	❌	`Servicios`	Concepto: productos, servicios o ambos.
`issuedAt`	`"YYYY-MM-DD"`	❌	Fecha de hoy	Fecha de emisión del comprobante.
`periodFrom`	`"YYYY-MM-DD"`	❌	Primer día del mes	Comienzo del período facturado, sólo para servicios.
`periodTo`	`"YYYY-MM-DD"`	❌	Último día del mes	Fin del período facturado, sólo para servicios.
`paymentDueAt`	`"YYYY-MM-DD"`	❌	`issuedAt`	Vencimiento del pago, sólo para servicios.
`salesCondition`	`SalesCondition`	❌	`Otra`	Forma de pago.
`salesPointId`	`number`	❌	El primer punto de venta	El punto de venta.

`Item`

Nombre	Tipo	Requerido	Default	Descripción
`description`	`string`	✅	—	Descripción del producto o servicio.
`quantity`	`number`	❌	`1`	Cantidad de productos o servicio.
`unitPrice`	`number`	✅	—	Precio por uinidad del producto o servicio.
`unitMeasureId`	`number`	❌	`7` ("unidades")	La unidad de medida de ARCA.

El precio se calcula como: unitPrice x quantity = Precio por producto.

`Customer`

Nombre	Tipo	Requerido	Default	Descripción
`taxCondition`	`CustomerTaxCondition`	❌	`ConsumidorFinal`	Condición frente al IVA del receptor.
`documentType`	`CustomerDocumentType`	❌	`None`	Tipo de documento del receptor. Podés dejarlo en blanco si es Consumidor Final.
`documentNumber`	`string \| number`	❌	—	Número de documento del receptor, con o sin guiones o puntos. Podés dejarlo en blanco si es Consumidor Final.
`name`	`string`	❌	—	Razón Social del receptor.
`address`	`string`	❌	—	Domicilio del receptor.

Enums

`VoucherType`

VoucherType.FacturaC;

`Concept`

Concept.Productos;
Concept.ProductosYServicios;
Concept.Servicios;

`CustomerDocumentType`

CustomerDocumentType.CUIL;
CustomerDocumentType.CUIT;
CustomerDocumentType.DNI;
CustomerDocumentType.None;

`CustomerTaxCondition`

CustomerTaxCondition.ClienteDelExterior;
CustomerTaxCondition.ConsumidorFinal;
CustomerTaxCondition.Exento;
CustomerTaxCondition.IvaLiberado;
CustomerTaxCondition.Monotributo;
CustomerTaxCondition.MonotributoPromovido;
CustomerTaxCondition.MonotributoSocial;
CustomerTaxCondition.NoAlcanzado;
CustomerTaxCondition.NoCategorizado;
CustomerTaxCondition.ProveedorDelExterior;
CustomerTaxCondition.ResponsableInscripto;

`SalesCondition`

SalesCondition.Contado;
SalesCondition.CuentaCorriente;
SalesCondition.Otra;
SalesCondition.TarjetaDeCredito;
SalesCondition.TarjetaDeDebito;
SalesCondition.TransferenciaBancaria;

Errores

Los códigos que puede devolver el SDK, y cómo mostrarlos, están en Manejo de errores.

Referencia del SDK

On this page