GuidesChangelog
HomeLog In
Guides
These docs are for v2023.1. Click to read the latest docs for v2024.2.

Purchase orders

Target audience

  • Customer organizations


Purpose

As opposed to creating a SalesOrder, creating a PurchaseOrder will not result in an error response when the given model does not match with the available supply from the supplier. A newly created PurchaseOrder will first be verified. If PurchaseOrder does not match the supply it will result in an "action required" for the deviating fields. e.g. Price diffence, Package difference, ...

The PurchaseOrder dashboard will shows the deviating PurchaseOrders with an action required and allows the user to change the values, choose a different supplyLine to order or create a supply, tradeItem, packingConfiguration or order request.

🚧

Purchase dashboard

Only use this endpoint in case the supply lines of a supplier are incomplete and if your client's employees actively use the Floriday purchase dashboard. In other cases, it will be better to place orders using CreateSalesOrder.



Guidance

Purchase order:

  • Specifies a purchase order based on a direct sales supply line or a trade item or VBN criteria by the customer organization for Floriday to process in the Floriday purchase dashboard for matching direct sales supply lines. If matched it will result in a newly created sales order. If there are no matches found the purchaseOrder will be enriched with the actions required containing the deviations found;
  • Contains a customer order reference, number of pieces, packing configuration and payment provider. Either a supply-line Id, tradeItem Id or VBN criteria. In addition an customer Organization Id, price per piece, additional service, delivery condition set, delivery remarks, purchasing agent and nextlegidentifier. The nextlegidentifier is used by customers to add an end customer reference, which they use to differentiate orders made by their end customers.
  • If a purchase order is matched with a direct sales supply-line in Floriday a sales order is created and no action is required by the customer organization in the purchase dashboard;
  • If a purchase order is not matched with a direct sales supply-line in Floriday the following possible action are required by customer organization in the purchase dashboard. Some of the actions required specifically 'supply request' or 'order request' are based on customer feedback and can change accordingly:

Possible actions required in purchase dashboard: supply request or order request:

  • DIFFERENT_PRICE
  • SUPPLY_UNAVAILABLE
  • NOT_ENOUGH_IN_STOCK
  • SUPPLY_INVALID_PERIOD
  • SUPPLY_EXPIRED
  • SUPPLY_NOT_FOUND
  • ORDER_REQUEST_REJECTED_BY_SUPPLIER

Possible actions required in purchase dashboard: Trade-item request:

  • TRADE_ITEM_CODE_DIFFERENCE
  • VBN_PRODUCT_CODE_DIFFERENCE
  • POT_SIZE_DIFFERENCE
  • TRADE_ITEM_NOT_FOUND

Possible actions required in purchase dashboard: Package configuration request

  • PACKAGE_DIFFERENCE
  • PIECES_PER_PACKAGE_DIFFERENCE
  • LOAD_CARRIER_DIFFERENCE
  • PACKAGES_PER_LAYER_DIFFERENCE
  • LAYERS_PER_LOAD_CARRIER_DIFFERENCE

Obsolete:

  • DIFFERENT_CARRIER_SETTING

Responses:

  • SALES_ORDER_REJECTED
  • FAILED_TO_CREATE_SALES_ORDER
  • NUMBER_OF_PIECES_INVALID_FOR_SALES_UNIT
  • UNKNOWN (No action required)


📘

Use the application

Please use the Floriday application for purchase dashboard and purchase orders for customer organizations and orders request (Match & Connect) and sales orders for a better understanding of the workflow and functions.

For more information please refer to our Helpcenter



Implementation model



Interactiemodel