Get a posting line
Módulo Finance
GET/posting-lines/{posting_line_id}postingLines.get
A Universal Posting Line (Bible tab 36): the one export shape, projected to every accounting platform. Returns one posting line with its `ETag`. A posting line the caller may not see returns 404.
- Requiere la capacidad finance.journal.read.
- Alcances de OAuth: finance.
- Estados de error: 400, 401, 404, 429. Los errores son detalles de problema RFC 9457.
Parámetros de ruta y de consulta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| posting_line_id | string (uuid) | Sí | Identifier of the posting line. |
| fields | Fields | No | Sparse fieldset: a comma-separated list of top-level fields to return. `id` is always returned.Restricciones: pattern ^[a-z_][a-z0-9_]*(,[a-z_][a-z0-9_]*)*$ |
Respuesta 200: PostingLine
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| org_id | string (uuid) | Sí | Identifier of the owning organization, derived from the parent row and never accepted from the caller. |
| date | string (date) | Sí | Date the cost or revenue is recognized. |
| account_code | GlAccountCode | Sí | GL account code from the fixed chart in `xpms.dim_gl_account` (Section 3.11).Restricciones: pattern ^[0-9]{4}$ |
| cost_center_id | CostCenterCode | null | Sí | |
| urid | UridAtAnyGrain | null | Sí | |
| vendor_id | string (uuid) | null | Sí | Identifier of the vendor organization; null for revenue. |
| item_id | ItemId | Sí | Catalog item identifier `{URID}-{ORG}-{SEQ}` (Section 3.6).Restricciones: pattern ^[0-9]000\.[0-9]{2}\.[0-9]{2}-[A-Z0-9]+-[0-9]+$ |
| description | string | Sí | Sentence-case line description.Restricciones: length 1 to 300 |
| quantity | number | null | Sí | Quantity. |
| unit_basis | UnitCode | Sí | Unit basis from the controlled unit list in `xpms.dim_unit_alias`.Restricciones: pattern ^[a-z][a-z0-9_-]*$ |
| amount_minor | integer (int64) | null | Sí | Signed amount; negative for credits. Integer minor units of the resource currency; null means unpriced, never zero. |
| tax_type | TaxType | Sí | Tax type from the Universal Posting Line specification (Bible tab 36).Restricciones: pattern ^[A-Z0-9][A-Za-z0-9&'/.()-]*( [A-Za-z0-9&'/.()-]+)*$ |
| currency | string | Sí | ISO 4217 currency code of every money field.Restricciones: pattern ^[A-Z]{3}$ |
| external_ref | string | null | Sí | Invoice, card transaction or record identifier.Restricciones: length 1 to 300 |
| line_state | SharedState | Sí | A value from the shared finance and commercial state vocabulary (Bible tab 37): the five core states plus declared domain extensions.Restricciones: pattern ^[A-Z0-9][A-Za-z0-9&'/.()-]*( [A-Za-z0-9&'/.()-]+)*$ |
| posting_line_id | string (uuid) | Sí | Identifier of the posting line. |
| project_id | string (uuid) | null | Sí | Identifier of the project. |
{
"org_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
"date": "2026-10-08",
"account_code": "5400",
"cost_center_id": "CC-VENUE",
"urid": "4000.01",
"vendor_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
"item_id": "4000.01.01-XPMS-001",
"description": "Stage deck rental for opening weekend.",
"quantity": 24,
"unit_basis": "each",
"amount_minor": 108000,
"tax_type": "Tax on Purchases",
"currency": "USD",
"external_ref": "INV-2026-0042",
"line_state": "Committed",
"posting_line_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
"project_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f"
}Ejemplos de código
curl -X GET "$XOS_BASE_URL/posting-lines/0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f" \
-H "Authorization: Bearer $XOS_API_KEY"const { data, etag } = await xos.postingLines.get("0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f");response = xos.posting_lines.get("0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f")xos posting-lines get 0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f