The identity and technical contract details declared by the specification.
BuyerAppOrderDocument
object
5 properties
5 required
OrderAdjustmentStatusEnum
string
available - Available pendingapplication - Pending Application applied - Applied void - Void
Country
string
AF - Afghanistan AX - Åland Islands AL - Albania DZ - Algeria AS - American Samoa AD - Andorra AO - Angola AI - Anguilla AQ - Antarctica AG - Antigua and Barbu…
ProviderBankDetails
object
2 properties
2 required
BuyerActivityStatementCurrency
object
The statement for a single currency, with opening / closing balance.
4 properties
4 required
OtifDataDeliveryIssueTypeNested
object
Nested serializer for delivery issue types in OTIF data.
3 properties
3 required
ServiceFeeMismatch
object
Shape of MerchantOfRecordAppOrderDetailsSerializer.servicefeemismatch (SC-3919). Present only when the order's fee disagrees with its linked OM contract; null…
3 properties
3 required
CreditCalculatorResponse
object
Response serializer for the credit calculator endpoint.
9 properties
8 required
BuyerGroupedStatementDetail
object
16 properties
16 required
OrderLineItemOtifDataEdit
object
Serializer for editing OTIF data within line item updates.
7 properties
AdminAppOrderEventCreate
object
1 property
SupplierAppOrderDetails
object
34 properties
27 required
PaginatedMerchantOfRecordSpotBuyRequestListList
object
4 properties
2 required
CatalogItemDocumentCategoryEnum
string
specsheet - Spec Sheet certificateofanalysis - Certificate of Analysis britishretailconsortium - British Retail Consortium internationalorganisationforstandard…
DisabledMonths
object
Response serializer for the disabled-months endpoint.
1 property
1 required
TwoRegistrationCheckResponse
object
Response serializer for Two registration check.
5 properties
1 required
CatalogItemSummary
object
Compact read-only summary of a BuyerItem or SupplierItem for embedding on order / agreement line-item read serializers. A plain Serializer (not ModelSerializer…
5 properties
5 required
ServiceFeeInvoiceCreate
object
2 properties
2 required
OrderAdjustmentTypeEnum
string
creditnote - Credit Note debitnote - Debit Note
MerchantOfRecordAppOrderDetails
object
MoR surface — uses the nested serializer that exposes supplierdocumenturl.
75 properties
54 required
CreditCalculatorRequest
object
Request serializer for the credit calculator endpoint.
3 properties
MerchantOfRecordTwoOrderStatus
object
Serializer for checking if an order has already been pushed to Two.
3 properties
1 required
BuyerRepeatSpotOrderRequest
object
Serializer for repeat spot order request information
4 properties
2 required
StaffUser
object
6 properties
6 required
BuyerOutstandingPaymentsSummary
object
Operational view of outstanding payments for the buyer finance page. All monetary values are in cents.
5 properties
5 required
GroupedStatementDetail
object
22 properties
22 required
PatchedSupplierAppOrderDispatch
object
Serializer for marking an order as dispatched with shipping details
4 properties
ExpectedPayoutStateEnum
string
due - Due overdue - Overdue
BuyerAppOrderDetails
object
Buyer surface — uses the nested serializer that hides supplierdocumenturl.
54 properties
46 required
BuyerServiceFeesListing
object
Serializer for the service fees listing response (separate from orders).
3 properties
3 required
OtifDataDeliveryIssueType
object
3 properties
3 required
QualityIssueTypeEnum
string
spoilage - Spoilage notmatchspec - Not Match Spec contamination - Contamination discolouration - Discolouration shelflifeissue - Shelf Life Issue
MerchantOfRecordSpotBuyRequestList
object
Read-only serializer for listing spot buy requests from the MoR perspective.
15 properties
15 required
BuyerAllocatedCreditResponse
object
Response serializer for the buyer allocated credit endpoint.
9 properties
9 required
SupplierPayoutDetails
object
20 properties
11 required
MerchantOfRecordBuyerPurchaseOrderPDFUrl
object
1 property
1 required
MerchantOfRecordAppOrderEvent
object
5 properties
5 required
MerchantOfRecordAppOrderDocument
object
6 properties
4 required
InsufficientCreditReasonEnum
string
exceedseffectiveavailable - Exceeds Effective Available exceedsperorderlimit - Exceeds Per Order Limit
MerchantOfRecordTwoCreditInformation
object
Serializer for Two credit information for MoR endpoints. All monetary values are in cents in the buyer's currency.
8 properties
7 required
ConfirmShippingResponsibility
object
Serializer for confirming shipping responsibility when transitioning from gatheringquotes state.
1 property
1 required
SupplierSite
object
3 properties
3 required
LegacyPayoutStatusEnum
string
TargetStatusEnum
string
orderreceived - Order Received ordersenttosupplier - Order Sent To Supplier orderconfirmingprice - Order Confirming Price
AdminAppOrderEvent
object
7 properties
5 required
GroupedStatementPatch
object
1 property
BuyerRepeatSpotOrderLineItem
object
2 properties
2 required
PDFUrl
object
1 property
1 required
CompanyNameAndId
object
3 properties
3 required
UnitOfMeasurementEnum
string
fl oz - Fluid Ounces g - Grams mg - milligrams gals - Gallons kg - Kilograms L - Liters tons - Metric Tons oz - Ounces lbs - Pounds pcs - Pieces pt - Pints ml…
BuyerAvailablePaymentSections
object
2 properties
2 required
BankingCountryTypeEnum
string
US - Us GB - Gb CA - Ca AT - At BE - Be CY - Cy DE - De EE - Ee ES - Es FI - Fi FR - Fr GR - Gr IE - Ie IT - It LT - Lt LU - Lu LV - Lv MT - Mt NL - Nl PT - Pt…
HoldInternalReasonEnum
string
supplierdelay - Supplier delay volumeconfirmation - Volume confirmation creditreview - Credit review documentsrequired - Documents required fraudreview - Fraud…
OrderLineItemOtifData
object
12 properties
5 required
PaginatedGroupedStatementListList
object
4 properties
2 required
LimitCheck
object
Credit limit with sufficiency check for a single provider.
3 properties
3 required
MerchantOfRecordAppOrderLineItemCreate
object
17 properties
3 required
PaginatedStaffUserList
object
4 properties
2 required
CreditLimits
object
Combined credit limits from Two and Allianz APIs.
3 properties
3 required
LegacyPaymentStatusEnum
string
PaginatedBuyerAppOrderListList
object
4 properties
2 required
OrderLineItemDocumentUpload
object
2 properties
2 required
AvailableCurrenciesEnum
string
EUR - EUR GBP - GBP USD - USD
DeliveryStateEnum
string
initializing - Initializing notstarted - Not Started pendingdispatch - Pending Dispatch intransit - In Transit delivered - Delivered freightownershippending -…
OrderOnHoldAlert
object
Serializer for orders on hold alert list.
8 properties
6 required
PaginatedUnifiedStatementListList
object
4 properties
2 required
ZendeskTicket
object
Serializer for Zendesk ticket data from the search API
4 properties
4 required
PayInStateEnum
string
initializing - Initializing notstarted - Not Started due - Due overdue - Overdue awaitingreconciliation - Awaiting Reconciliation paid - Paid refunded - Refund…
BuyerTwoCreditInformation
object
Serializer for buyer's Two credit summary. Monetary values are in cents in the buyer's currency. totalcredit and availableforneworders are null whenever status…
7 properties
7 required
PaginatedBuyerGroupedStatementListList
object
4 properties
2 required
PaginatedMerchantOfRecordOrderActivityList
object
4 properties
2 required
StatementList
object
Statement list representation for service fee invoices.
15 properties
13 required
BuyerOrderLineItem
object
15 properties
10 required
BuyerSpotBuyRequestList
object
Read-only serializer for listing spot buy requests.
10 properties
10 required
BuyerGroupedStatementList
object
14 properties
14 required
MerchantOfRecordAppOrderEdit
object
37 properties
LegacyLifecycleStatusEnum
string
PaginatedBuyerOrderActivityList
object
4 properties
2 required
PaginatedMerchantOfRecordAppOrderDocumentList
object
4 properties
2 required
TwoRecourseCreditLimit
object
Credit limit data for Two recourse credit.
5 properties
5 required
AppOrderPaymentTermsEnum
string
paybeforedispatch - Pay Before Dispatch payafterdispatch - Pay After Dispatch payon28thsecondmonthafterdispatch - Pay on 28th second month after dispatch payen…
PayoutStateEnum
string
initializing - Initializing notstarted - Not Started due - Due overdue - Overdue paid - Paid refunded - Refunded partiallyrefunded - Partially Refunded
AccountTypeEnum
string
checking - Checking savings - Savings
StatementOrder
object
Nested order representation within a statement detail.
12 properties
7 required
PatchedOrderLineItemOtifData
object
12 properties
OrderLineItemOtifDataNested
object
Nested serializer for reading OTIF data within line items.
8 properties
8 required
AllocatedCreditBreakdown
object
Breakdown of allocated credit by order state.
5 properties
5 required
OrderLineItemDocument
object
3 properties
3 required
UnifiedStatementListSourceEnum
string
servicefee - servicefee two - two
BuyerSpotBuyRequest
object
Serializer for creating and reading spot buy requests
10 properties
3 required
BuyerAppOrderListSuppliers
object
Serializer for supplier with uuid, name, and lead time (drives the order-request calendar block).
3 properties
2 required
BuyerOrderActivity
object
Serializer for reading order activities for buyer users.
6 properties
6 required
PatchedGroupedStatementPatch
object
1 property
SupplierPayoutTermsEnum
string
payoutbeforedispatch - Payout Before Dispatch payoutafterdispatch - Payout After Dispatch
SpotBuyLineItem
object
Serializer for line items in spot buy request. unit and price are accepted as free-form strings (kg / cases / etc. for unit; a single value or a range like "10…
5 properties
2 required
SupplierOrderLineItem
object
16 properties
9 required
AdminAppOrderUpdate
object
4 properties
1 required
ProviderAllocatedCreditWithForecast
object
Allocated credit for a provider, including forecasted order total.
3 properties
3 required
BuyerPaymentRowKindEnum
string
order - Order servicefeeinvoice - Service fee invoice
BuyerServiceFeeInvoice
object
Serializer for a service fee invoice in the payments listing (flat, not grouped by month).
11 properties
11 required
PaginatedMerchantOfRecordAppOrderEventList
object
4 properties
2 required
InternalReasonEnum
string
supplierdelay - Supplier delay volumeconfirmation - Volume confirmation creditreview - Credit review documentsrequired - Documents required fraudreview - Fraud…
MerchantOfRecordOrderCompany
object
Minimal company shape (uuid + name) for the MoR orders-list filter dropdowns. Drives the Supplier / Buyer filter options, which must reflect the counterparties…
2 properties
2 required
SpotBuyRequestStatusEnum
string
pending - Pending completed - Completed cancelled - Cancelled
PaginatedAdminAppOrderDocumentList
object
4 properties
2 required
PaymentBucket
object
2 properties
2 required
OutstandingBucket
object
A single per-currency Outstanding money bucket (minor units).
2 properties
2 required
PayoutStateForDateRequest
object
Serializer for payout state lookup request.
1 property
1 required
GroupedStatementStatusEnum
string
due - Due overdue - Overdue awaitingreconciliation - Awaiting Reconciliation paid - Paid cancelled - Cancelled
AdminAppOrderPrice
object
5 properties
3 required
BuyerAppOrderList
object
36 properties
29 required
CreditRiskOwnerEnum
string
two - Two allianz - Allianz opply - Opply
DuplicateOrderResponse
object
Serializer for duplicate order response
1 property
1 required
MerchantOfRecordOrderActivityFeedItem
object
Read-only feed serializer used by the MoR home dashboard's order activity widget. Same fields as MerchantOfRecordOrderActivitySerializer, plus the order identi…
14 properties
14 required
MerchantOfRecordAppOrderCreate
object
Serializer for creating new app orders by merchant of record companies. This serializer handles the creation of app orders with validation to ensure: - Buyer a…
31 properties
7 required
PatchedMerchantOfRecordAppOrderDispatch
object
4 properties
LifecycleStateEnum
string
initializing - Initializing confirmed - Confirmed canceled - Cancelled pendingmerchantofrecordapproval - Pending Merchant of Record Approval orderreceived - Or…
BuyerNestedOrderAdjustment
object
Slim adjustment payload for the buyer-facing inline arrays on order-detail. Used by BuyerAppOrderDetailsSerializer to expose originatingadjustments and applied…
17 properties
17 required
TwoOrganicCreditLimit
object
Credit limit data for Two organic (non-recourse) credit.
8 properties
8 required
MerchantOfRecordAppOrderEventCreate
object
1 property
1 required
TwoOrganicLimitCheck
object
Two organic limit with per-order limit.
4 properties
4 required
PaginatedBuyerBalanceList
object
4 properties
2 required
BuyerServiceFeeOrder
object
Serializer for an individual order nested within a service fee statement entry.
7 properties
7 required
GroupedStatementList
object
18 properties
18 required
StatementSummary
object
Status-count summary over the merged service-fee + Two statement set, plus the per-currency Outstanding money total (Two/grouped only, never summed across curr…
4 properties
4 required
User
object
7 properties
3 required
MerchantOfRecordPushToTwoResponse
object
Serializer for the response when pushing an order to Two.
5 properties
2 required
OutstandingPayment
object
14 properties
14 required
LegacyDeliveryStatusEnum
string
PaginatedAdminAppOrderEventList
object
4 properties
2 required
AppOrderEventTypeEnum
string
markorderaspaidout - Mark order as paid out markaspaid - Mark as paid approvedbymerchantofrecord - Approved by merchant of record rejectedbymerchantofrecord -…
PaymentProviderEnum
string
stripe - Stripe two - Two direct - Direct
BuyerStripePaymentListing
object
Serializer for the Stripe payments order listing response.
3 properties
3 required
PaginatedOrderOnHoldAlertList
object
4 properties
2 required
BuyerBalance
object
4 properties
4 required
PaginatedBuyerSpotBuyRequestListList
object
4 properties
2 required
MerchantOfRecordOrderLineItem
object
28 properties
17 required
AppOrderDocumentType
string
supplierinvoice - Supplier Invoice deliverynote - Delivery Note organic - Organic halal - Halal tradingschedule - Trading Schedule kosher - Kosher certificateo…
DeliveryTracking
object
4 properties
4 required
ServiceTypeEnum
string
ingredientsourcing - Ingredient Sourcing sampling - Sampling other - Other
GroupedStatementOrphanOrder
object
Schema for a single entry in the grouped-statement warnings list. Surfaces dispatched Two orders whose estimated due date matches the statement but whose twoin…
3 properties
3 required
TaskStateEnum
string
todo - To Do done - Done
UnmarkForecasted
object
Serializer for unmarking an order as forecasted, with optional credit risk owner.
1 property
BuyerActivityStatement
object
Buyer activity statement grouped by currency. All monetary values are in integer cents. The cumulative outstanding balance is server-computed from the same sou…
3 properties
3 required
BuyerOrderAggregateResult
object
5 properties
5 required
PatchedMerchantOfRecordOrderActivityUpdate
object
Serializer for updating order activity
1 property
AdminAppOrderDetails
object
40 properties
25 required
BuyerPaymentOrder
object
Serializer for an individual order in the payments listing.
11 properties
11 required
MarkForecasted
object
Serializer for marking an order as forecasted with a target date.
1 property
1 required
PaginatedBuyerOrderActivityWithOrderList
object
4 properties
2 required
PaginatedZendeskTicketList
object
4 properties
2 required
AppOrderDocumentCategory
string
uploadedbyadmin - Uploaded by admin uploadedbysupplier - Uploaded by supplier uploadedbymerchantofrecord - Uploaded by merchant of record uploadedbybuyer - Upl…
AdminOrderLineItem
object
17 properties
14 required
PatchedMerchantOfRecordSpotBuyRequestUpdate
object
Serializer for updating spot buy request status (pending - completed).
1 property
BuyerPaymentAnalytics
object
2 properties
2 required
MerchantOfRecordAppOrderLineItemEdit
object
20 properties
1 required
RefundTypeEnum
string
payin - Pay In payout - Payout
SpotBuySku
object
Serializer for SKUs in spot buy request
2 properties
2 required
MerchantOfRecordSupplierPurchaseOrderPDFUrl
object
1 property
1 required
BuyerOrderActivityWithOrder
object
Serializer for reading order activities with order information for buyer users. Used for the listallorderactivities endpoint.
8 properties
8 required
MerchantOfRecordAppOrderDispatch
object
4 properties
2 required
UnifiedStatementList
object
Flat list row for the unified MoR statements endpoint. Merges the service-fee and Two (grouped) sources into one shape with a source discriminator. Serialized…
17 properties
17 required
BuyerGroupedStatementOrder
object
Order summary nested inside a buyer's grouped statement detail response.
11 properties
11 required
PatchedBuyerAppOrderDetails
object
Buyer surface — uses the nested serializer that hides supplierdocumenturl.
54 properties
MerchantOfRecordTwoBillingAccount
object
Serializer for Two billing account information for MoR endpoints.
5 properties
2 required
RefundCreate
object
5 properties
2 required
SupplierAppOrderList
object
20 properties
17 required
BuyerRepeatSpotOrderResponse
object
Serializer for repeat spot order response information
1 property
1 required
ServiceFeeStatusEnum
string
notstarted - Not Started invoicesent - Invoice Sent paid - Paid
PaginatedBrandUserList
object
4 properties
2 required
AvailablePaymentProvidersEnum
string
stripe - Stripe two - Two direct - Direct
MerchantOfRecordTwoRecourseInformation
object
Serializer for Two recourse information for MoR endpoints
6 properties
6 required
PayoutStateForDateResponse
object
Serializer for payout state lookup response.
2 properties
2 required
AdminAppOrderDocument
object
6 properties
4 required
BuyerClientNotifiedAsPaid
object
1 property
BrandUser
object
3 properties
3 required
AdminOrderLineItemPrices
object
12 properties
8 required
CreditSummary
object
Buyer credit summary under the shared max() envelope. Single backend-computed view of a buyer's credit, from CreditLimitService.summariseforbuyer. Consumed by…
6 properties
6 required
BuyerMarkAsPickedUp
object
Serializer for marking an order as picked up by the buyer.
4 properties
2 required
ConfirmShippingResponsibilityShippingResponsibilityEnum
string
supplier - Supplier buyer - Buyer merchantofrecord - Merchant of Record
PaginatedBuyerAppOrderListSuppliersList
object
4 properties
2 required
ChangePaymentTerms
object
Serializer for changing payment terms on a confirmed/forecasted order.
4 properties
PaginatedAdminAppOrderListList
object
4 properties
2 required
BuyerMerchantOfRecordItem
object
Polymorphic row inside the merged Merchant-of-Record listing. Each row is either a Stripe order (type='order') or a service-fee statement (type='servicefeeinvo…
13 properties
12 required
PaginatedStatementListList
object
4 properties
2 required
AllianzCreditLimit
object
Credit limit data for Allianz/recourse credit.
3 properties
3 required
ReportingUnitsEnum
string
g - Grams kg - Kilograms mg - milligrams long tons - Long Tons short tons - Short Tons metric tons - Metric Tons oz - Ounces lbs - Pounds uk fl oz - UK Fluid O…
AdminLineItemUpdate
object
2 properties
1 required
DeliveryAddressResponse
object
12 properties
1 required
OrderHoldDetails
object
Serializer for displaying hold details on an order.
6 properties
4 required
MerchantOfRecordSpotBuyRequestLineItem
object
A spot-buy line as the MoR sees it, with the resolved buyer material.
5 properties
5 required
BuyerTwoCreditStatusEnum
string
available - Available notconfigured - Not Configured revoked - Revoked apierror - API Error
ShortUser
object
3 properties
2 required
PaymentFilters
object
Serializer for the available filter options.
1 property
1 required
AdminAppOrderList
object
17 properties
9 required
GroupedStatementOrder
object
Order summary nested in a grouped statement detail response. Distinct from StatementOrderSerializer (used by ServiceFeeInvoice), which exposes service-fee subt…
9 properties
9 required
CreditCalculatorLimits
object
All credit limits for the calculator response.
3 properties
3 required
PaginatedMerchantOfRecordOrderActivityFeedItemList
object
4 properties
2 required
MerchantOfRecordInvoiceUrlResponse
object
Serializer for invoice URL response for Stripe and Two
1 property
1 required
BuyerMerchantOfRecordPaymentsListing
object
Combined Merchant-of-Record payments listing — Stripe (MoR) orders and service-fee statements in a single sorted, paginated list. Each item is a polymorphic ro…
4 properties
4 required
MerchantOfRecordOrderActivityCreate
object
Serializer for creating order activities by merchant of record companies.
10 properties
1 required
SpotBuyAttachment
object
2 properties
2 required
StatementDetail
object
Statement detail with nested orders and bank details.
18 properties
15 required
ShippingResponsibilityEnum
string
buyer - Buyer supplier - Supplier unknown - Unknown tobeconfirmed - To Be Confirmed merchantofrecord - Merchant of Record
BankDetail
object
Serializer for a single bank detail entry (label/value pair).
2 properties
2 required
MerchantOfRecordNestedOrderAdjustment
object
MoR variant of the nested order-detail adjustment payload — adds supplierdocumenturl, which the buyer surface must not expose. Subclassing rather than sharing…
18 properties
18 required
PaginatedSupplierAppOrderListList
object
4 properties
2 required
MerchantOfRecordAppOrderLineItemAdd
object
Serializer for adding new line items to an existing order.
17 properties
3 required
CreditLimitStatusEnum
string
available - Available notconnected - Not Connected notconfigured - Not Configured apierror - API Error
ProviderAllocatedCredit
object
Allocated credit for a single payment provider.
2 properties
2 required
BuyerPayableOverdueRef
object
Lean reference to the oldest non-Two overdue payment. Returned alongside the summary so the buyer-app overdue banner can surface a one-click Pay Now CTA — the…
7 properties
7 required
OrderActivityDocument
object
Serializer for order activity documents
3 properties
3 required
OrderActivityCategory
string
confirmingprice - Confirming Price priceconfirmed - Price Confirmed confirmingdeliverydate - Confirming Delivery deliverydateconfirmed - Delivery Confirmed not…
OrderHoldCreate
object
Serializer for creating an order hold.
3 properties
1 required
MerchantOfRecordAppOrderList
object
13 properties
8 required
BuyerActivityStatementEntry
object
One order on the statement, with the cumulative outstanding balance.
6 properties
6 required
PaginatedMerchantOfRecordAppOrderListList
object
4 properties
2 required
MerchantOfRecordOrderActivity
object
Serializer for reading order activities with all fields including internal status and task fields.
12 properties
12 required
MerchantOfRecordAllianzCreditInformation
object
Serializer for Allianz credit information for MoR endpoints
7 properties
7 required
MoveLifecycleIntermediateStatus
object
Serializer for moving order to an intermediate lifecycle status.
1 property
1 required
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Opply publishes across the network.