Factuarea APIDevelopers
Añadido

Ofertas y precio anterior

Pon productos y packs en oferta con fechas y canales. Las lecturas exponen la oferta y el precio anterior legal, y la resolución de precios admite fecha, canal y el cliente de la web.

Las ofertas ya forman parte del contrato público. Están disponibles en todos los planes que incluyen productos, desde Esencial.

  • Un recurso nuevo promotions crea ofertas con artículos, fechas y canales (documents y web), con sus propios scopes promotions:read, promotions:write y promotions:delete.
  • La lectura de productos y packs incluye siempre promotion (la oferta o null) con label, previous_price, reduction_percent y announce_reduction.
  • price-lists/resolve y price-lists/resolve-many admiten date, channel y client_id. La tarifa se elige como en un documento: manda un price_list_id (null significa sin tarifa) y, si no, rige la tarifa predeterminada del cliente. Una tarifa inactiva responde 422.
  • Cada precio resuelto lleva regular_unit_price, regular_source y promotion (null cuando no se aplica ninguna). Los importes gross usan el IVA del artículo y el régimen de la empresa. Para el importe exacto, con el recargo de equivalencia o la exención del cliente, usa el cálculo de totales.
  • El desglose de precio de un pack admite client_id y channel, y devuelve la oferta del pack con su precio habitual.
  • Las tarifas y sus precios admiten los filtros updated[gte] y updated[lte]. El updated_at de una tarifa también se mueve cuando cambia uno de sus precios.
  • Las líneas de documento admiten sold_on y channel, para que una oferta solo web llegue a la factura del pedido. Una venta web cobrada al precio de oferta cuenta como vendida con la oferta.
  • Las plantillas PDF añaden la opción show_regular_price, que imprime el precio habitual y la rebaja bajo el concepto de una línea vendida con oferta.

Lee Ofertas y precio anterior y Tu tienda con Factuarea.

Eventos

EventoCambio
promotion.created, promotion.updated, promotion.started, promotion.ended y promotion.cancelledNuevos, con la oferta
promotion.deletedNuevo, con {id, object: "promotion", deleted: true}
price_list.created, price_list.updated y price_list.item_updatedNuevos, con la tarifa o el precio. Úsalos para refrescar una caché de precios
price_list.deleted y price_list.item_deletedNuevos, con {id, object, deleted: true}. El precio lleva su price_list_id
product.updated y pack.updatedTambién cuando una oferta empieza o termina

Errores nuevos: promotion_not_found, promotion_started, promotion_read_only, invalid_promotion_item y duplicate_promotion_item. El servidor MCP añade list_promotions, get_promotion, create_promotion, update_promotion, cancel_promotion y delete_promotion, y resolve_catalog_price y resolve_many_catalog_prices admiten client_id.

Nuevos endpoints6

EndpointDescripción
GET/v1/companies/{company}/promotionsListar todas las ofertas
POST/v1/companies/{company}/promotionsCrear una oferta
GET/v1/companies/{company}/promotions/{promotion}Consultar una oferta
PATCH/v1/companies/{company}/promotions/{promotion}Actualizar una oferta
DEL/v1/companies/{company}/promotions/{promotion}Eliminar una oferta
POST/v1/companies/{company}/promotions/{promotion}/cancelCancelar una oferta

Endpoints actualizados67

EndpointDescripción
POST/v1/companies/{company}/pdf-templates/{template}/archiveArchivar una plantilla de PDF
POST/v1/companies/{company}/invoices/bulk-createCrear facturas en bloque
POST/v1/accounts/{account}/webhooksCrear un webhook endpoint de cuenta
POST/v1/accounts/{account}/api-keysCrear una API key
POST/v1/companies/{company}/delivery-notesCrear un albarán
POST/v1/companies/{company}/invoicesCrea una factura
POST/v1/companies/{company}/pdf-template-previewsCrear una vista previa de plantilla de PDF
POST/v1/companies/{company}/price-listsCrear una tarifa
GET/v1/companies/{company}/price-listsListar tarifas
POST/v1/companies/{company}/productsCrear un producto
GET/v1/companies/{company}/productsListar todos los productos
POST/v1/companies/{company}/products/{product}/presentationsCrear una presentación de producto
GET/v1/companies/{company}/products/{product}/presentationsListar presentaciones de producto
POST/v1/companies/{company}/products/{product}/variantsCrear una variante de producto
GET/v1/companies/{company}/products/{product}/variantsListar variantes de producto
POST/v1/companies/{company}/proformasCrea una proforma
POST/v1/companies/{company}/purchase-invoicesCrea un gasto
POST/v1/companies/{company}/quotesCrea un presupuesto
POST/v1/companies/{company}/recurring-invoicesCrea una factura recurrente
POST/v1/companies/{company}/pdf-templatesCrear una plantilla de PDF
GET/v1/companies/{company}/pdf-templatesListar las plantillas de PDF
POST/v1/companies/{company}/webhook-endpointsCrea un webhook endpoint
GET/v1/companies/{company}/webhook-endpointsListar todos los webhook endpoints
PATCH/v1/accounts/{account}/webhooks/{webhook}Actualizar un webhook endpoint de cuenta
PATCH/v1/companies/{company}/delivery-notes/{delivery_note}Actualizar un albarán
PATCH/v1/companies/{company}/invoices/{invoice}Actualizar una factura
GET/v1/companies/{company}/price-lists/{priceList}Consultar una tarifa
PATCH/v1/companies/{company}/price-lists/{priceList}Actualizar una tarifa
GET/v1/companies/{company}/products/{product}Obtener un producto
PATCH/v1/companies/{company}/products/{product}Actualizar un producto
PATCH/v1/companies/{company}/products/{product}/presentations/{presentation}Actualizar una presentación de producto
PATCH/v1/companies/{company}/products/{product}/variants/{variant}Actualizar una variante de producto
POST/v1/companies/{company}/products/{product}/videoSube un vídeo a un producto
PATCH/v1/companies/{company}/proformas/{proforma}Actualizar una proforma
PATCH/v1/companies/{company}/purchase-invoices/{purchase_invoice}Actualizar un gasto
PATCH/v1/companies/{company}/quotes/{quote}Actualizar un presupuesto
PATCH/v1/companies/{company}/recurring-invoices/{recurring_invoice}Actualizar una factura recurrente
GET/v1/companies/{company}/webhook-endpoints/{webhook_endpoint}Obtener un webhook endpoint
PATCH/v1/companies/{company}/webhook-endpoints/{webhook_endpoint}Actualizar un webhook endpoint
POST/v1/companies/{company}/pdf-templates/{template}/duplicateDuplicar una plantilla de PDF
POST/v1/companies/{company}/products/find-by-external-idBuscar un producto por external ID
POST/v1/companies/{company}/products/find-by-skuBuscar un producto por SKU
GET/v1/companies/{company}/pdf-templates/{template}Obtener una plantilla de PDF
PATCH/v1/companies/{company}/pdf-templates/{template}Actualizar los metadatos de una plantilla de PDF
GET/v1/companies/{company}/products/low-stock-reportLista los productos por debajo del umbral de stock
GET/v1/companies/{company}/pdf-templates/{template}/revisions/{revision}Obtener una revisión de plantilla de PDF
GET/v1/companies/{company}/eventsListar todos los eventos
GET/v1/companies/{company}/price-lists/{priceList}/itemsListar ítems de tarifa
POST/v1/companies/{company}/price-lists/{priceList}/itemsHacer upsert de un ítem de tarifa
GET/v1/companies/{company}/price-lists/optionsListar opciones de tarifas activas
GET/v1/companies/{company}/products/{product}/configurationsListar combinaciones comerciales de un producto
GET/v1/companies/{company}/webhook-endpoints/{webhook_endpoint}/deliveriesLista las entregas de webhook
POST/v1/companies/{company}/pdf-templates/{template}/revisionsPublicar una revisión de plantilla de PDF
POST/v1/companies/{company}/price-lists/{priceList}/items/{item}/reassignReasignar una entrada de tarifa retirada
POST/v1/companies/{company}/products/{product}/base-unit-replacementSustituir un producto cambiando su unidad base
POST/v1/companies/{company}/price-lists/resolveResolver un precio de catálogo
POST/v1/companies/{company}/products/{product}/resolve-selectionResolver una selección de catálogo
POST/v1/companies/{company}/price-lists/resolve-manyResolver varios precios de catálogo
POST/v1/companies/{company}/pdf-templates/{template}/restoreRestaurar una plantilla de PDF
POST/v1/companies/{company}/webhook-endpoints/{webhook_endpoint}/rotate-secretRota el secreto del webhook
GET/v1/companies/{company}/products/searchBusca productos
POST/v1/accounts/{account}/webhooks/{webhook}/testEnviar un evento de prueba a un webhook endpoint de cuenta
POST/v1/companies/{company}/webhook-endpoints/{webhook_endpoint}/test-eventEnviar un evento de prueba
GET/v1/companies/{company}/events/{event}Obtener un evento
GET/v1/companies/{company}/webhook-endpoints/{webhook_endpoint}/deliveries/{delivery}Recupera la entrega del webhook
POST/v1/companies/{company}/products/{product}/toggle-activeAlternar el estado activo del producto
PATCH/v1/companies/{company}/products/{product}/stockActualizar el stock de un producto

En esta página

¿Te echamos una mano?Contactar con soporte