REST API: Sincronización de compras y ventas

rememberme · obligatorio — Token de sesión que devuelve el login.

order · opcional — Id del centro de coste (Centros de coste). Por defecto, el centro activo del usuario.

cursor string · opcional — Cursor de la llamada anterior. Si se envía, se ignoran changedSince y $filter.

changedSince date · opcional — Cambios desde este día, en formato AAAA-MM-DD. No puede ser posterior a hoy.

$filter string · opcional — Filtro sobre los campos de cada endpoint (ver Filtro). Queda guardado en el cursor: solo se envía en la primera llamada.

rows integer · opcional — Cambios por página, de 1 a 100. Por defecto, 100.

includeInternal boolean · opcional — false excluye los proveedores o clientes de tipo interno. Por defecto, true.

inserts array — Documentos creados desde el cursor. En la primera carga, todos.

updates array — Documentos creados antes y modificados después. Cada documento aparece una sola vez, con su estado actual.

deletes array — Documentos eliminados: id string y deletedAt date.

cursor string — Para la siguiente llamada. Es null si la primera carga no devuelve nada.

hasMore boolean — true si hay más cambios disponibles.

Los cambios de los últimos 5 minutos llegan en la siguiente llamada.

deletes no aplica filtros: ignora los id que no tengas.

Un documento que deja de cumplir el filtro no aparece en deletes.

Un mismo id puede venir en updates y en deletes de la misma página: aplica el más reciente comparando updatedAt y deletedAt.

Los cambios en los datos del proveedor o del cliente (nombre, NIF, cuentas…) no marcan sus documentos como modificados.

Fechas: AAAA-MM-DD sin comillas. Admiten todos los operadores.

Ids: número sin comillas. Solo eq, ne e in.

Texto: entre comillas simples. Solo eq, ne, in y contains(). Distingue mayúsculas y acentos.

onlyValidated boolean · opcional — true devuelve solo facturas validadas. Por defecto, false.

idVendor string · opcional — Solo las facturas de este proveedor.

id string — Identificador de la factura.

invoiceNum string — Número de factura del proveedor.

documentNum string — Número de documento interno.

date, dateAccounting, dateDue date — Fecha de factura, fecha contable (si es null, usa date) y vencimiento.

createdAt, updatedAt date — Creación y última modificación.

idVendor, vendor, codeVendor, accountVendor, nif string — Proveedor: id, nombre, código, cuenta contable y NIF.

inEuropeanUnion, inVies boolean — Proveedor intracomunitario e inscrito en VIES.

country string — País del proveedor.

paid, validated, locked boolean — Pagada, validada y bloqueada.

comment string — Comentario.

codePaymentType string — Código de la forma de pago.

idCostTypeVendor, costTypeVendor, codeCostTypeVendor, accountCostTypeVendor, accountAuxCostTypeVendor string — Cuenta analítica por defecto del proveedor: id, nombre, código, cuenta contable y cuenta auxiliar.

idBusinessLine, businessLine, codeBusinessLine string — Línea de negocio.

idDocument, extDocument string — Documento adjunto: id y extensión.

base, taxes, total number — Base imponible, impuestos y total. total incluye la retención.

listTaxes array — Impuestos: id, type, base, percent y total. type: 0 IVA · 1 transporte · 2 descuento · 3 otros · 4 retención.

listCostTypeTaxes array — IVA por cuenta analítica, calculado con las líneas recibidas: id y descr de la cuenta (null si las líneas no tienen) y listTaxes (type, base, percent, total).

listDeliveries array — Albaranes de la factura, con los campos de Albaranes de compra (sin createdAt ni updatedAt).

idVendor string · opcional — Solo los albaranes de este proveedor.

id string — Identificador del albarán.

deliveryNum string — Número de albarán.

deliveryFor string — Referencia del albarán, normalmente el número de pedido.

date date — Fecha de recepción; si no hay, la de envío. dateFormatted string — La misma, en AAAA/MM/DD.

dateSent date — Fecha de envío del pedido. dateSentFormatted string — La misma, en AAAA/MM/DD.

createdAt, updatedAt date — Creación y última modificación.

idVendor, vendor, codeVendor, accountVendor, nif string — Proveedor: id, nombre, código, cuenta contable y NIF.

vendorType, vendorTypeCode string, vendorTypeInternal boolean — Tipo de proveedor: nombre, código y si es interno.

locked boolean — Bloqueado.

sentBy, receivedBy string — Quién hizo el pedido y quién lo recibió.

idCostType, costType, codeCostType, accountCostType, accountAuxCostType string — Cuenta analítica del albarán. Si se imputa por línea, va en cada línea.

idBusinessLine, businessLine, codeBusinessLine string — Línea de negocio.

baseCalculated number — Base calculada con las líneas recibidas, con 5 decimales.

base, taxes, total number — Base, impuestos (incluye transporte, descuentos y otros) y total.

listTaxes array — Impuestos: id, type, base, percent y total. type: 0 IVA · 1 transporte · 2 descuento · 3 otros.

listDeliveries array — Líneas recibidas.

listSent array — Líneas del pedido enviado.

id string — Identificador de la línea. position integer — Orden.

idComponent, component, codeComponent string — Producto: id, nombre y código.

codeVendorComponent string — Código del producto en el proveedor.

comment string — Comentario.

quantity number, idUnit, unit string — Cantidad en la unidad base del producto.

cost number — Coste por unidad base. Importe de la línea: quantity × cost.

hasFormat boolean — Si se compró en un formato (p. ej. cajas).

quantityFormat number, idUnitFormat, unitFormat string, costFormat number — Formato: cantidad, unidad y precio por formato. null si hasFormat es false.

idStore, store string — Almacén.

iva number — % de IVA.

idCostType, costType, codeCostType, accountCostType, accountAuxCostType string — Cuenta analítica de la línea.

idBusinessLine, businessLine, codeBusinessLine string — Línea de negocio de la línea.

listTypes array — Familias del producto: id y descr.

recibido boolean — Siempre true.

idCustomer string · opcional — Solo las facturas de este cliente.

id string — Identificador de la factura.

invoiceNum string — Número de factura.

documentNum string — Número de documento.

date, dateAccounting, dateDue date — Fecha de factura, fecha contable (si es null, usa date) y vencimiento.

createdAt, updatedAt date — Creación y última modificación.

idCustomer, customer, codeCustomer, accountCustomer, nif string — Cliente: id, nombre, código, cuenta contable y NIF.

paid, locked boolean — Cobrada y bloqueada.

comment string — Comentario.

codePaymentType string — Código de la forma de pago.

idCostTypeVendor, costTypeVendor, codeCostTypeVendor, accountCostTypeVendor, accountAuxCostTypeVendor string — Cuenta analítica por defecto del cliente: id, nombre, código, cuenta contable y cuenta auxiliar.

idDocument, extDocument string — Documento adjunto: id y extensión.

base, taxes, total number — Base imponible, impuestos y total.

listTaxes array — Impuestos: id, type, base, percent y total. type: 0 IVA · 1 transporte · 2 descuento · 3 otros.

listCostTypeTaxes array — IVA por cuenta analítica, calculado con las líneas enviadas: id y descr de la cuenta (null si las líneas no tienen) y listTaxes (type, base, percent, total).

listDeliveries array — Albaranes de venta de la factura.

id string — Identificador del albarán.

invoiceNum string — Número de albarán.

date date — Fecha del albarán.

idCustomer, customer, customerCode, nif string — Cliente: id, nombre, código y NIF.

address, cp, city string — Dirección, código postal y ciudad del cliente.

contact, phone, contactAux, phoneAux, mail, mailAux, mailCC, web string — Contactos del cliente.

customerType, customerTypeCode string, customerTypeInternal boolean — Tipo de cliente: nombre, código y si es interno.

base number — Base de las líneas enviadas.

listLines, listLinesPending array — Líneas enviadas y pendientes de enviar.

id string — Identificador de la línea. position integer — Orden dentro de la lista, desde 0.

idComponent, component, codeComponent string — Producto vendido.

idMenu, menu, codeMenu string — Agrupación vendida.

codeCustomerProduct string — Código de venta del producto para el cliente.

idCustomerGroup, customerGroup string — Grupo de productos.

comment string — Comentario. En líneas sin producto ni agrupación, el nombre del producto de venta.

sent boolean — Enviada.

quantity number, idUnit, unit string — Cantidad y unidad.

cost number — Precio de venta unitario sin IVA.

costRecipe number — Coste unitario de escandallo.

iva number — % de IVA.

listTypes array — Familias del producto: id y descr.