Factuarea APIDevelopers
Suport
Ves a l'app
Afegit

Ofertes i preu anterior

Posa productes i packs en oferta amb dates i canals. Les lectures exposen l'oferta i el preu anterior legal, i la resolució de preus admet data, canal i el client de la web.

Les ofertes ja formen part del contracte públic. Estan disponibles a tots els plans que inclouen productes, des d'Esencial.

  • Un recurs nou promotions crea ofertes amb articles, dates i canals (documents i web), amb els seus propis scopes promotions:read, promotions:write i promotions:delete.
  • La lectura de productes i packs inclou sempre promotion (l'oferta o null) amb label, previous_price, reduction_percent i announce_reduction.
  • price-lists/resolve i price-lists/resolve-many admeten date, channel i client_id. La tarifa es tria com en un document: mana un price_list_id (null significa sense tarifa) i, si no, regeix la tarifa predeterminada del client. Una tarifa inactiva respon 422.
  • Cada preu resolt porta regular_unit_price, regular_source i promotion (null quan no s'aplica cap). Els imports gross usen l'IVA de l'article i el règim de l'empresa. Per a l'import exacte, amb el recàrrec d'equivalència o l'exempció del client, fes servir el càlcul de totals.
  • El desglossament de preu d'un pack admet client_id i channel, i retorna l'oferta del pack amb el seu preu habitual.
  • Les tarifes i els seus preus admeten els filtres updated[gte] i updated[lte]. L'updated_at d'una tarifa també es mou quan canvia un dels seus preus.
  • Les línies de document admeten sold_on i channel, perquè una oferta només web arribi a la factura de la comanda. Una venda web cobrada al preu d'oferta compta com a venuda amb l'oferta.
  • Les plantilles PDF afegeixen l'opció show_regular_price, que imprimeix el preu habitual i la rebaixa sota el concepte d'una línia venuda amb oferta.

Llegeix Ofertes i preu anterior i La teva botiga amb Factuarea.

Esdeveniments

EsdevenimentCanvi
promotion.created, promotion.updated, promotion.started, promotion.ended i promotion.cancelledNous, amb l'oferta
promotion.deletedNou, amb {id, object: "promotion", deleted: true}
price_list.created, price_list.updated i price_list.item_updatedNous, amb la tarifa o el preu. Fes-los servir per refrescar una memòria cau de preus
price_list.deleted i price_list.item_deletedNous, amb {id, object, deleted: true}. El preu porta el seu price_list_id
product.updated i pack.updatedTambé quan una oferta comença o acaba

Errors nous: promotion_not_found, promotion_started, promotion_read_only, invalid_promotion_item i duplicate_promotion_item. El servidor MCP afegeix list_promotions, get_promotion, create_promotion, update_promotion, cancel_promotion i delete_promotion, i resolve_catalog_price i resolve_many_catalog_prices admeten client_id.

Nous endpoints6

EndpointDescripció
GET/v1/companies/{company}/promotionsLlistar totes les ofertes
POST/v1/companies/{company}/promotionsCrear una oferta
GET/v1/companies/{company}/promotions/{promotion}Consultar una oferta
PATCH/v1/companies/{company}/promotions/{promotion}Actualitzar una oferta
DEL/v1/companies/{company}/promotions/{promotion}Eliminar una oferta
POST/v1/companies/{company}/promotions/{promotion}/cancelCancel·lar una oferta

Endpoints actualitzats67

EndpointDescripció
POST/v1/companies/{company}/pdf-templates/{template}/archiveArxivar una plantilla PDF
POST/v1/companies/{company}/invoices/bulk-createCrear factures en bloc
POST/v1/accounts/{account}/webhooksCrear un webhook endpoint de compte
POST/v1/accounts/{account}/api-keysCrear una API key
POST/v1/companies/{company}/delivery-notesCrear un albarà
POST/v1/companies/{company}/invoicesCrea una factura
POST/v1/companies/{company}/pdf-template-previewsCrear una vista prèvia de plantilla PDF
POST/v1/companies/{company}/price-listsCrear una tarifa
GET/v1/companies/{company}/price-listsLlistar tarifes
POST/v1/companies/{company}/productsCrear un producte
GET/v1/companies/{company}/productsLlistar tots els productes
POST/v1/companies/{company}/products/{product}/presentationsCrear una presentació de producte
GET/v1/companies/{company}/products/{product}/presentationsLlistar presentacions de producte
POST/v1/companies/{company}/products/{product}/variantsCrear una variant de producte
GET/v1/companies/{company}/products/{product}/variantsLlistar variants de producte
POST/v1/companies/{company}/proformasCrea una proforma
POST/v1/companies/{company}/purchase-invoicesCrea una despesa
POST/v1/companies/{company}/quotesCrea un pressupost
POST/v1/companies/{company}/recurring-invoicesCrea una factura recurrent
POST/v1/companies/{company}/pdf-templatesCrear una plantilla PDF
GET/v1/companies/{company}/pdf-templatesLlistar les plantilles PDF
POST/v1/companies/{company}/webhook-endpointsCrea un webhook endpoint
GET/v1/companies/{company}/webhook-endpointsLlistar tots els webhook endpoints
PATCH/v1/accounts/{account}/webhooks/{webhook}Actualitzar un webhook endpoint de compte
PATCH/v1/companies/{company}/delivery-notes/{delivery_note}Actualitzar un albarà
PATCH/v1/companies/{company}/invoices/{invoice}Actualitzar una factura
GET/v1/companies/{company}/price-lists/{priceList}Consultar una tarifa
PATCH/v1/companies/{company}/price-lists/{priceList}Actualitzar una tarifa
GET/v1/companies/{company}/products/{product}Obtenir un producte
PATCH/v1/companies/{company}/products/{product}Actualitzar un producte
PATCH/v1/companies/{company}/products/{product}/presentations/{presentation}Actualitzar una presentació de producte
PATCH/v1/companies/{company}/products/{product}/variants/{variant}Actualitzar una variant de producte
POST/v1/companies/{company}/products/{product}/videoPuja un vídeo a un producte
PATCH/v1/companies/{company}/proformas/{proforma}Actualitzar una proforma
PATCH/v1/companies/{company}/purchase-invoices/{purchase_invoice}Actualitzar una despesa
PATCH/v1/companies/{company}/quotes/{quote}Actualitzar un pressupost
PATCH/v1/companies/{company}/recurring-invoices/{recurring_invoice}Actualitzar una factura recurrent
GET/v1/companies/{company}/webhook-endpoints/{webhook_endpoint}Obtenir un webhook endpoint
PATCH/v1/companies/{company}/webhook-endpoints/{webhook_endpoint}Actualitzar un webhook endpoint
POST/v1/companies/{company}/pdf-templates/{template}/duplicateDuplicar una plantilla PDF
POST/v1/companies/{company}/products/find-by-external-idCercar un producte per external ID
POST/v1/companies/{company}/products/find-by-skuCercar un producte per SKU
GET/v1/companies/{company}/pdf-templates/{template}Obtenir una plantilla PDF
PATCH/v1/companies/{company}/pdf-templates/{template}Actualitzar les metadades d'una plantilla PDF
GET/v1/companies/{company}/products/low-stock-reportLlista els productes per sota del llindar d'stock
GET/v1/companies/{company}/pdf-templates/{template}/revisions/{revision}Obtenir una revisió de plantilla PDF
GET/v1/companies/{company}/eventsLlistar tots els esdeveniments
GET/v1/companies/{company}/price-lists/{priceList}/itemsLlistar ítems de tarifa
POST/v1/companies/{company}/price-lists/{priceList}/itemsFer upsert d’un ítem de tarifa
GET/v1/companies/{company}/price-lists/optionsLlistar opcions de tarifes actives
GET/v1/companies/{company}/products/{product}/configurationsLlistar combinacions comercials d'un producte
GET/v1/companies/{company}/webhook-endpoints/{webhook_endpoint}/deliveriesLlista les entregues de webhook
POST/v1/companies/{company}/pdf-templates/{template}/revisionsPublicar una revisió de plantilla PDF
POST/v1/companies/{company}/price-lists/{priceList}/items/{item}/reassignReassignar una entrada de tarifa retirada
POST/v1/companies/{company}/products/{product}/base-unit-replacementSubstituir un producte canviant la seva unitat base
POST/v1/companies/{company}/price-lists/resolveResoldre un preu de catàleg
POST/v1/companies/{company}/products/{product}/resolve-selectionResoldre una selecció de catàleg
POST/v1/companies/{company}/price-lists/resolve-manyResoldre diversos preus de catàleg
POST/v1/companies/{company}/pdf-templates/{template}/restoreRestaurar una plantilla PDF
POST/v1/companies/{company}/webhook-endpoints/{webhook_endpoint}/rotate-secretRota el secret del webhook
GET/v1/companies/{company}/products/searchCerca productes
POST/v1/accounts/{account}/webhooks/{webhook}/testEnviar un esdeveniment de prova a un webhook endpoint de compte
POST/v1/companies/{company}/webhook-endpoints/{webhook_endpoint}/test-eventEnviar un esdeveniment de prova
GET/v1/companies/{company}/events/{event}Obtenir un esdeveniment
GET/v1/companies/{company}/webhook-endpoints/{webhook_endpoint}/deliveries/{delivery}Recupera el lliurament del webhook
POST/v1/companies/{company}/products/{product}/toggle-activeAlternar l'estat actiu del producte
PATCH/v1/companies/{company}/products/{product}/stockActualitzar l'stock d'un producte
Anterior

Packs i un aparador comú per a productes

Els packs tenen la seva pròpia API amb imatges i vista d'aparador, els productes es poden publicar a la web amb preu amb i sense IVA, i les factures admeten línies de pack amb el preu cobrat.

Següent

Raó social i nom comercial

name és el nom amb què es coneix una empresa i business_name la seva raó social quan és diferent. Les respostes segueixen aquest contracte a totes les empreses, l'edició parcial es resol sobre els noms actuals i tots dos camps admeten fins a 100 caràcters.

En aquesta pàgina

Esdeveniments
Et donem un cop de mà?Contactar amb suport