---
title: "Document Types"
description: "The 65 UBL 2.1 document types this package models, one PHP class per document"
type: "docs"
category: "doc"
tags: []
authors: [Anonymous]
date: "2026-10-12"
last_update: "2026-10-12"
time_minutes: 6
draft: false
unlisted: false
url: "https://www.derafu.dev/docs/data/ubl/documents"
---

# Document Types

Every document type defined by UBL 2.1 is available as a class under `Derafu\Ubl\Oasis\Doc\`,
named exactly like the document (`Quotation`, `Invoice`, `CreditNote`, ...). There is no
sub-namespace per business domain: most of the underlying building blocks (`Party`,
`MonetaryTotal`, `TaxTotal`, every `*Line` type) are shared across nearly all of them
regardless of domain, and a document does not belong to a single domain either (an `Invoice`
is billing, but it is referenced from other flows through `BillingReference`).

## Available Documents

| Class | Definition |
|---|---|
| `ApplicationResponse` | A document to indicate the application's response to a transaction. |
| `AttachedDocument` | A wrapper that allows a document of any kind to be packaged with the UBL document that references it. |
| `AwardedNotification` | The document used to communicate a contract award to the winner. |
| `BillOfLading` | A document issued by the party who acts as an agent for a transportation carrier or other agents to the party who gives instructions for the transportation services (shipper, consignor, etc.) stating the details of the transportation, charges, and terms and conditions under which the transportation service is provided. |
| `CallForTenders` | A document used by a Contracting Party to define a procurement project to buy goods, services, or works during a specified period. |
| `Catalogue` | A document that describes items, prices, and price validity. |
| `CatalogueDeletion` | A document used to cancel an entire Catalogue. |
| `CatalogueItemSpecificationUpdate` | A document used to update information (e.g., technical descriptions and properties) about Items in an existing Catalogue. |
| `CataloguePricingUpdate` | A document used to update information about prices in an existing Catalogue. |
| `CatalogueRequest` | A document used to request a Catalogue. |
| `CertificateOfOrigin` | A document that describes the Certificate of Origin. |
| `ContractAwardNotice` | A document published by a Contracting Party to announce the awarding of a procurement project. |
| `ContractNotice` | A document used by a Contracting party to announce a project to buy goods, services, or works. |
| `CreditNote` | A document used to specify credits due to the Debtor from the Creditor. |
| `DebitNote` | A document used to specify debts incurred by the Debtor. |
| `DespatchAdvice` | A document used to describe the despatch or delivery of goods and services. |
| `DocumentStatus` | A document used to provide information about document status. |
| `DocumentStatusRequest` | A document used to request the status of another document. |
| `ExceptionCriteria` | A document used to specify the thresholds for forecast variance, product activity, and performance history beyond which exceptions should be triggered. |
| `ExceptionNotification` | A document used to notify an exception in forecast variance, product activity, or performance history. |
| `Forecast` | A document used to forecast sales or orders. |
| `ForecastRevision` | A document used to revise a Forecast. |
| `ForwardingInstructions` | A document issued to a forwarder, giving instructions regarding the action to be taken for the forwarding of goods described therein. |
| `FreightInvoice` | A document stating the charges incurred for a logistics service. |
| `FulfilmentCancellation` | A document used to cancel an entire fulfilment document (Despatch Advice or Receipt Advice). |
| `GoodsItemItinerary` | A document providing details relating to a transport service, such as transport movement, identification of equipment and goods, subcontracted service providers, etc. |
| `GuaranteeCertificate` | A document to notify the deposit of a bid bond guarantee. |
| `InstructionForReturns` | A document used to initiate a return of goods. |
| `InventoryReport` | A report on the quantities of each item that are, or will be, in stock. |
| `Invoice` | A document used to request payment. |
| `ItemInformationRequest` | A document used to request product activity, forecast, or performance data. |
| `Order` | A document used to order goods and services. |
| `OrderCancellation` | A document used to cancel an entire Order. |
| `OrderChange` | A document used to specify changes to an existing Order. |
| `OrderResponse` | A document used to indicate detailed acceptance or rejection of an Order or to make a counter-offer. |
| `OrderResponseSimple` | A document used to indicate simple acceptance or rejection of an entire Order. |
| `PackingList` | A document describing how goods are packed. |
| `PriorInformationNotice` | A document used by a contracting party to declare the intention to buy goods, services, or works during a specified period. |
| `ProductActivity` | A document reporting the movement of goods at specified retail locations for inventory tracking purposes. |
| `Quotation` | A document used to quote for the provision of goods and services. |
| `ReceiptAdvice` | A document used to describe the receipt of goods and services. |
| `Reminder` | A document used to remind a customer of payments past due. |
| `RemittanceAdvice` | A document that specifies details of an actual payment. |
| `RequestForQuotation` | A document used to request a Quotation for goods and services from a Seller. |
| `RetailEvent` | A document used to specify basic information about retail events (such as promotions, product introductions, and community or environmental events) that affect supply or demand. |
| `SelfBilledCreditNote` | A credit note created by the debtor in a self billing arrangement with a creditor; Self Billed Credit Note replaces Debit Note in such arrangements. |
| `SelfBilledInvoice` | An Invoice document created by the Customer (rather than the Supplier) in a Self Billing relationship. |
| `Statement` | A document used to report the status of orders, billing, and payment. |
| `StockAvailabilityReport` | A report on the quantities of each item that are, or will be, in stock. |
| `Tender` | A document whereby an economic operator (the tenderer) makes a formal offer (the tender) to a contracting authority to execute an order for the supply or purchase of goods, or for the execution of work, according to the terms of a proposed contract. |
| `TenderReceipt` | A document sent by a contracting party to an economic operator acknowledging receipt of a Tender. |
| `TendererQualification` | A document declaring the qualifications of a tenderer. |
| `TendererQualificationResponse` | A document issued by a procurement organization to notify an economic operator whether it has been admitted to or excluded from the tendering process. |
| `TradeItemLocationProfile` | A document specifying trade item attributes relating to replenishment policies. |
| `TransportExecutionPlan` | A document used in the negotiation of a transport service between a transport user and a transport service provider. |
| `TransportExecutionPlanRequest` | A document sent by a transport user to request a transport service from a transport service provider. |
| `TransportProgressStatus` | A document sent from a Transportation Network Manager to a Transport Service Provider giving the status of the whereabouts and schedule of the transport means involved in a transport service. |
| `TransportProgressStatusRequest` | A document sent from a transport service provider to a transportation network manager requesting a Transport Progress Status. |
| `TransportServiceDescription` | A document sent by a transport service provider to announce the availability of a transport service. |
| `TransportServiceDescriptionRequest` | A document requesting a Transport Service Description, sent from a party with a transport demand (transport user) to a party providing transport services (transport service provider). |
| `TransportationStatus` | A document to circulate reports of transportation status or changes in status (events) among a group of participants. |
| `TransportationStatusRequest` | A document requesting a Transportation Status report. |
| `UnawardedNotification` | A document communicating to a tenderer that the contract has been awarded to different tenderer. |
| `UtilityStatement` | A supplement to an Invoice or Credit Note, containing information on the consumption of services provided by utility suppliers to private and public customers, including electricity, gas, water, and telephone services. |
| `Waybill` | A transport document describing a shipment. |

## Working with a Document

A document is a plain object: build it with its setters, or hydrate one from data with
`fromArray()`. See **Introduction** for a complete example, and **Formats** for reading and
writing documents as `json`, `yaml` or `xml`.



---
Last updated on 12/10/2026