{"uid":"cap_io4rhMJN67fl8EPZhYbfA","slug":"ubl-receipt-advice-accepted-rejected-shortage-partition-f57068cf","name":"UBL Receipt Advice Accepted/Rejected/Shortage Partition","description":"Separate accepted, rejected, short and excess quantities across partial receipts.","url":"https://detect.halowerk.com/v1/F-TD2000-DOCUMENTS-01/ubl-receipt-advice-accepted-rejected-shortage-partition?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"artifact":{"type":"object","required":["receiptBalances"],"properties":{"receiptBalances":{"type":"object","required":["data","claim"],"properties":{"data":{"type":"object","required":["despatch_lines","receipts"],"properties":{"receipts":{"type":"array","items":{"type":"object","required":["id","despatch_line","received","rejected"],"properties":{"id":{"type":"string","maxLength":64},"received":{"type":"integer","maximum":1000000000,"minimum":0},"rejected":{"type":"integer","maximum":1000000000,"minimum":0},"despatch_line":{"type":"string","maxLength":64}},"additionalProperties":false},"maxItems":64,"minItems":0},"despatch_lines":{"type":"array","items":{"type":"object","required":["id","quantity"],"properties":{"id":{"type":"string","maxLength":64},"quantity":{"type":"integer","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":32,"minItems":1}},"additionalProperties":false},"claim":{"anyOf":[{"type":"null"},{"type":"object","required":["lines"],"properties":{"lines":{"type":"array","items":{"type":"object","required":["accepted","despatched","id","oversupply","received","rejected","short"],"properties":{"id":{"type":"string","maxLength":20000},"short":{"type":"integer"},"accepted":{"type":"integer"},"received":{"type":"integer"},"rejected":{"type":"integer"},"despatched":{"type":"integer"},"oversupply":{"type":"integer"}},"additionalProperties":false},"maxItems":4096}},"additionalProperties":false}]}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mZvEZQ7JbkngGWQwmoSJL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Partitions receipt quantities across despatch lines into accepted, rejected, short, and excess (oversupply) buckets for partial receipt scenarios.","exampleAgentPrompt":"We received a partial shipment against despatch line DL-001 (originally 100 units dispatched). The warehouse logged 80 units received, 10 of which were rejected. Can you partition this into accepted, rejected, short, and oversupply quantities?","exampleUseCases":[{"title":"Partial shipment discrepancy resolution","prompt":"We got a partial delivery for order PO-5523. Despatch line DL-100 had 200 units sent, but we only received 150 and rejected 20 of those. Break that down into accepted, short, rejected, and oversupply quantities for the receipt advice."},{"title":"Multi-line receipt reconciliation","prompt":"I have three despatch lines from our supplier — DL-A (50 units), DL-B (80 units), DL-C (30 units) — and multiple partial receipts across them with some rejections. Partition all the quantities into accepted, rejected, shortage, and excess buckets for each line."},{"title":"Oversupply detection on warehouse intake","prompt":"Our warehouse received 120 units against a despatch line that only called for 100 units, and they rejected 5 of the extras. Can you compute the accepted, rejected, short, and oversupply breakdown so I can generate the UBL receipt advice?"}],"resultDescription":"Returns a structured breakdown per despatch line including accepted, rejected, short (under-delivery), oversupply (excess), received, and despatched integer quantities — suitable for constructing a UBL Receipt Advice document.","failureModes":["Missing required despatch_lines or receipts arrays returns a validation error","Receipt referencing an unknown despatch_line ID causes a reconciliation error","Quantities exceeding the maximum of 1,000,000,000 are rejected with schema validation failure","Empty despatch_lines array (minItems:1 violated) returns a 400-level error","Payment not provided or insufficient USDC results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to programmatically reconcile UBL-compliant despatch and receipt data into structured accepted/rejected/short/oversupply quantities, especially in procurement automation pipelines handling partial deliveries, warehouse intake, or ERP receipt advice generation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:41:00.029Z","isFirstParty":false,"canonicalSlug":"ubl-receipt-advice-accepted-rejected-shortage-partition-f57068cf"}