Cómo armar el link para los casos de todos los días, como identificar al receptor, facturar productos o un período pasado, elegir la unidad de medida y el CUIT que lo emite.
Cada guía resuelve un caso concreto. Los parámetros completos están en la referencia.
Sin customer, la factura sale a un Consumidor Final sin identificar. Para
identificar al receptor, pasá su condición frente al IVA y su documento:
import {
CustomerDocumentType,
CustomerTaxCondition,
Factumono,
VoucherType,
} from "@factumono/sdk";
const url = Factumono.createVoucherUrl({
type: VoucherType.FacturaC,
items: [{ description: "Diseño de logo", unitPrice: 350000 }],
customer: {
taxCondition: CustomerTaxCondition.ResponsableInscripto,
documentType: CustomerDocumentType.CUIT,
documentNumber: "30-00000000-7", // con o sin guiones y puntos
name: "Tostadero del Sur S.A.",
address: "Av. Siempreviva 742",
},
});Qué documento pide cada receptor:
Receptor (taxCondition) | documentType |
|---|---|
ConsumidorFinal (es el valor por defecto) | Ninguno. DNI, CUIT o CUIL si lo conocés. |
ConsumidorFinal desde $10.000.000 | DNI, CUIT o CUIL: es obligatorio. |
Monotributo y sus variantes | CUIT |
Cualquier otro (ResponsableInscripto, etc.) | CUIT o CUIL |
documentNumber sin documentType, el SDK lo toma como CUIT.documentNumber: CustomerDocumentType.None
no admite número.name (la Razón Social) y address (el domicilio) son opcionales y se
imprimen en la factura.El SDK no verifica que el CUIT del receptor exista ni que su dígito verificador sea correcto (solo lo hace para un Consumidor Final desde $10.000.000). Un CUIT mal escrito arma el link igual y el error aparece recién al emitir. Si tu sistema carga CUITs, validalos antes de armar el link.
Este es el mismo chequeo de formato que hace Factumono con el CUIT del emisor: 11 dígitos, un prefijo válido y el dígito verificador.
function esCuitValido(cuit: string): boolean {
const digitos = cuit.replace(/\D/g, "");
if (!/^(20|23|24|25|26|27|30|33|34)\d{9}$/.test(digitos)) return false;
const pesos = [5, 4, 3, 2, 7, 6, 5, 4, 3, 2];
const suma = pesos.reduce(
(total, peso, i) => total + peso * Number(digitos[i]),
0,
);
const resto = 11 - (suma % 11);
if (resto === 10) return false;
return (resto === 11 ? 0 : resto) === Number(digitos[10]);
}concept dice qué se factura y cambia qué fechas hacen falta:
concept | Fechas que lleva la factura |
|---|---|
Servicios (por defecto) | Emisión, período facturado (periodFrom–periodTo) y vencimiento del pago (paymentDueAt) |
ProductosYServicios | Igual que Servicios |
Productos | Solo la emisión: no hace falta período ni vencimiento |
Si no pasás fechas, la factura es de hoy, el período es el mes de la fecha de
emisión y el vencimiento es la fecha de emisión. Todas las fechas son días
de Argentina escritos como texto "AAAA-MM-DD". Un Date o un timestamp da
error, porque el día que representa depende de la zona horaria.
Una venta de productos de hace unos días:
import {
Concept,
Factumono,
SalesCondition,
VoucherType,
} from "@factumono/sdk";
const url = Factumono.createVoucherUrl({
type: VoucherType.FacturaC,
concept: Concept.Productos,
issuedAt: "2026-10-30", // la fecha de la venta
items: [
{
description: "Café en grano",
quantity: 3,
unitPrice: 18000,
unitMeasureId: 1, // kilogramos
},
{ description: "Filtros de papel", quantity: 2, unitPrice: 4500 },
],
salesCondition: SalesCondition.Contado,
});Un servicio de octubre, facturado el 2 de noviembre y que se paga a 15 días:
import { Factumono, SalesCondition, VoucherType } from "@factumono/sdk";
const url = Factumono.createVoucherUrl({
type: VoucherType.FacturaC,
items: [{ description: "Consultoría", quantity: 8, unitPrice: 40000 }],
issuedAt: "2026-11-02",
periodFrom: "2026-10-01", // el período facturado: todo octubre
periodTo: "2026-10-31",
paymentDueAt: "2026-11-17", // 15 días después de issuedAt
salesCondition: SalesCondition.CuentaCorriente,
});Para calcular estas fechas en tu sistema, tomá el día de hoy en Argentina, no el de tu servidor:
// Hoy en Argentina, como "AAAA-MM-DD", corra donde corra tu código.
const hoy = new Intl.DateTimeFormat("en-CA", {
timeZone: "America/Argentina/Buenos_Aires",
}).format(new Date());
// Un día "AAAA-MM-DD" más (o menos) n días.
function sumarDias(dia: string, dias: number): string {
const fecha = new Date(`${dia}T12:00:00Z`);
fecha.setUTCDate(fecha.getUTCDate() + dias);
return fecha.toISOString().slice(0, 10);
}
const vencimiento = sumarDias(hoy, 15);Qué fechas acepta ARCA, contando desde el día en que se abre el link:
| Fecha | Límite |
|---|---|
issuedAt | Hasta 10 días antes o después de hoy. |
issuedAt con Concept.Productos | Hasta 5 días antes o después de hoy, y nunca en un mes posterior al actual. |
periodTo | No puede ser anterior a periodFrom. |
paymentDueAt | No puede ser anterior a issuedAt. |
Los límites se cuentan por hora, no por día: una fecha justo en el borde (a 10 o a 5 días) puede fallar según la hora en que se abre el link. Dejá un día de margen.
El SDK valida las fechas el día que arma la URL, y Factumono las vuelve a validar el día que tu cliente abre el link. Por eso:
La forma más simple de generarlo en el momento es que el botón apunte a tu servidor, y que tu servidor arme el link y redirija. Si la venta ya quedó fuera de los límites, el SDK no arma el link: respondé con un mensaje que tu cliente entienda en vez de un error.
import { Factumono, ValidationError, VoucherType } from "@factumono/sdk";
// GET /ventas/facturar?id=123: el botón "Facturar" de tu sistema apunta acá.
export async function GET(request: Request): Promise<Response> {
const venta = await buscarVenta(new URL(request.url).searchParams.get("id"));
try {
const url = Factumono.createVoucherUrl({
type: VoucherType.FacturaC,
issuedAt: venta.fecha,
items: venta.lineas.map((linea) => ({
description: linea.nombre,
quantity: linea.cantidad,
unitPrice: linea.precio,
})),
});
return Response.redirect(url, 302);
} catch (error) {
if (!(error instanceof ValidationError)) throw error;
// Por ejemplo, issuedAtMax10DaysPast: la venta es de hace más de 10 días.
const vencida = error.errors.some(({ path }) => path === "issuedAt");
return new Response(
vencida
? "Esta venta ya no se puede facturar con su fecha: ARCA no la acepta."
: "No pudimos armar la factura. Revisá los datos de la venta.",
{ status: 422 },
);
}
}unitPrice × quantity. Dos unidades a $50.000 son $100.000.quantity acepta decimales: media hora (0.5), 2,5 kilos (2.5).unitPrice puede ser 0 (una línea sin cargo), nunca negativo.description, hasta 4000
caracteres.unitMeasureId es el código de la unidad de medida de ARCA. Si no lo pasás,
es 7 (unidades). El SDK exporta las más usadas en COMMON_MEASURE_UNITS:
unitMeasureId | Unidad |
|---|---|
| 7 | unidades |
| 98 | otras unidades |
| 1 | kilogramos |
| 14 | gramos |
| 5 | litros |
| 2 | metros |
| 3 | metros cuadrados |
| 4 | metros cúbicos |
| 9 | docenas |
| 8 | pares |
| 96 | packs |
| 29 | toneladas |
ARCA no tiene una unidad para horas: una hora de trabajo o una sesión se
facturan como 7 (unidades). Un paquete que vendés entero también es una
unidad; 96 (packs) es para cuando la línea cuenta packs de varias unidades.
Los códigos 0, 95, 97 y 99 están reservados por ARCA y dan error.
salesCondition se imprime en la factura; ARCA no la recibe. Si no la pasás,
dice "Otra".
SalesCondition | Cuándo usarla |
|---|---|
Contado | Efectivo o pago en el momento. |
TarjetaDeDebito | Tarjeta de débito. |
TarjetaDeCredito | Tarjeta de crédito. |
TransferenciaBancaria | Transferencia bancaria. |
CuentaCorriente | Se paga más adelante. Combinala con paymentDueAt. |
Otra | Cualquier otro caso. |
taxId es el CUIT del emisor: en qué CUIT de Factumono se abre el
comprobante.
import { Factumono, VoucherType } from "@factumono/sdk";
const url = Factumono.createVoucherUrl({
type: VoucherType.FacturaC,
taxId: "20-00000000-1", // con o sin guiones
items: [
{ description: "Sesión de kinesiología", quantity: 2, unitPrice: 25000 },
],
});taxId, el comprobante se abre en el último CUIT que tu cliente
usó en Factumono desde ese navegador. Alcanza si tu cliente tiene un solo CUIT.taxId, el SDK verifica que sea un CUIT válido (11 dígitos y
dígito verificador) y Factumono abre ese CUIT.Sin salesPointId, Factumono usa el 400, el punto de venta que crea al dar
de alta la facturación, con el domicilio fiscal del CUIT. Si tu cliente tiene
otros locales cargados en ARCA, Factumono crea uno más por cada domicilio: 401,
402 y así. Pasalo solo para facturar desde uno de esos locales.
Tiene que ser un punto de venta que creó Factumono, del 400 al 499. El que tu cliente usa en ARCA para Comprobantes en línea no sirve: el formulario no lo muestra, y ARCA rechaza el comprobante al emitirlo. El SDK no sabe qué puntos de venta tiene cada CUIT, así que un número que no corresponde arma el link igual y el error aparece recién al emitir.
import { Factumono, VoucherType } from "@factumono/sdk";
const url = Factumono.createVoucherUrl({
type: VoucherType.FacturaC,
salesPointId: 401, // el segundo local de tu cliente
items: [{ description: "Corte de pelo", unitPrice: 15000 }],
});