Para saber más
Importes y monedas
Todo importe monetario es una cadena decimal con dos decimales, como "1234., nunca un número de coma flotante, con una excepción: los precios de priceConfig y defaultExpenses de un servicio y el customPrice de un accesorio son números JSON. Cada documento lleva su propia moneda, que puede diferir de la de la cuenta.
Los importes se serializan como cadenas decimales con exactamente dos decimales, redondeadas half up (ROUND_HALF_UP). La cadena evita la pérdida de precisión que causan los números de coma flotante. Por ejemplo, una factura devuelve subTotal como "1234.. El formato documentado admite un signo menos inicial para los valores negativos.
- Interpreta los importes con un tipo decimal:
Decimalen Python, una librería decimal o céntimos enteros en JavaScript. No usesparseFloatnifloat. - No redondees ni sumes con aritmética de coma flotante. Suma con un tipo decimal y redondea la mitad hacia arriba al final.
- Compara cadenas solo después de normalizarlas al mismo número de decimales.
| Dirección | Formato |
|---|---|
| Respuesta | Siempre "1234.: dos decimales. |
| Petición | Envía el importe también como cadena decimal, con un máximo de dos decimales (salvo los precios de servicios y accesorios indicados arriba, que son números JSON). Por ejemplo, POST /api acepta "250. o "250", mayor que cero. La excepción es PUT /api, cuyas cantidades, precios unitarios, tipos de impuesto y totales admiten hasta seis decimales y un signo menos inicial; las respuestas siguen dando dos. |
Una moneda es un código ISO 4217 como EUR. La cuenta tiene una moneda por defecto, que puedes leer en el campo currency de GET /api, pero la especificación indica que «documents may carry their own». Por tanto, una factura devuelve su propio currency, y debes usar ese campo, no el de la cuenta, cuando sumes documentos.
Envía la moneda al registrar un pago
POST /api acepta un currency y usa EUR por defecto si lo omites. Envía de forma explícita la moneda del documento al que pertenece el pago en lugar de depender del valor por defecto.
No sumes nunca importes de monedas distintas. La API no hace ninguna conversión. Para el resto de formatos, consulta tipos de datos.
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasGuías
Tipos de datos
El dinero es una cadena decimal, las fechas son ISO 8601, una propiedad puede estar presente y ser null, y los campos personalizados son mapas. Interpreta cada tipo una sola vez, en el borde de tu integración.
Para saber más
Fechas y horas
Las respuestas dan las fechas en UTC. Cuando escribes, envía un instante ISO 8601 con desplazamiento. Una fecha sin hora como
2026-10-17se lee en la zona horaria del negocio de la cuenta cuando está en un filtro; una escritura solo la admite en un campo que sea una fecha simple.
¿Te ha resultado útil esta página?