{"uid":"cap_BU7OeLw5rLGC_T9bINJOW","slug":"halowerk-invoice-extract-f1723ddc","name":"HALOWERK Invoice Extract","description":"Reads a hybrid invoice and returns it as data. Accepts a PDF with an embedded ZUGFeRD or Factur-X XML, or the EN 16931 XML on its own, in either syntax the standard allows: CII, which ZUGFeRD and Factur-X use, and UBL, which XRechnung and Peppol BIS use.","url":"https://handel.halowerk.com/v1/invoice-extract?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"include_lines":{"type":"boolean","default":true,"description":"Whether to return the individual invoice lines. False returns only header, tax breakdown and totals."},"verify_totals":{"type":"boolean","default":true,"description":"Whether to recompute the stated totals from the lines and the tax breakdown and report every deviation."},"document_base64":{"type":"string","maxLength":250000,"minLength":16,"description":"The document as base64. Either a PDF with an embedded ZUGFeRD or Factur-X XML, or the EN 16931 XML itself (CII or UBL). The JSON body of this hub is capped at 256 kB, so the base64 text must stay below 250000 characters, which is roughly 187 kB of file."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_D1ooHPVPCXJDWcq8vOcF0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses a hybrid electronic invoice (ZUGFeRD, Factur-X, XRechnung, or Peppol BIS) from a base64-encoded PDF or XML and returns structured invoice data including header, line items, tax breakdown, and totals.","exampleAgentPrompt":"I have a ZUGFeRD invoice PDF encoded in base64 — can you extract all the structured data from it, including the line items and tax breakdown, and flag any discrepancies between the stated totals and the computed ones?","exampleUseCases":[{"title":"Automated accounts payable ingestion","prompt":"I've got a batch of incoming supplier invoices as ZUGFeRD PDFs — can you extract all the header info, line items, and tax breakdowns from this one so I can feed it into our accounting system? Here's the base64-encoded PDF."},{"title":"Invoice total discrepancy check","prompt":"Something looks off on this Factur-X invoice — can you parse the embedded XML, pull all the line items and totals, and tell me if the stated total actually matches what you compute from the lines and tax breakdown? Here's the document in base64."},{"title":"XRechnung data extraction for ERP","prompt":"We receive XRechnung XML files from German public-sector clients and need the structured data — buyer, seller, line items, taxes, and totals — without the line items, just header and totals this time. Here's the base64-encoded UBL XML."}],"resultDescription":"A structured JSON object containing the parsed invoice data: header fields (buyer, seller, invoice number, dates, currency), line items (if requested), tax breakdown by rate, stated and computed totals, and a list of any deviations found between stated and recomputed figures.","failureModes":["Document too large: base64 string exceeds 250,000 characters — returns an error","No embedded XML found: PDF does not contain a ZUGFeRD or Factur-X attachment — returns parsing error","Malformed XML: embedded or standalone XML does not conform to EN 16931 CII or UBL syntax","Unsupported format: non-invoice PDF or unrecognized XML structure — returns format error","Base64 decoding failure: invalid base64 string — returns decoding error","Total verification mismatch: returns computed vs stated totals with deviation details rather than failing"],"whenToPreferThis":"Choose this endpoint when you need to programmatically extract structured data from European electronic invoices in hybrid PDF (ZUGFeRD, Factur-X) or standalone XML (XRechnung, Peppol BIS, EN 16931 CII/UBL) formats. It is especially valuable for accounts payable automation, ERP ingestion pipelines, or compliance workflows where you need both extracted data and automatic total verification in a single call. Prefer it over generic PDF extraction tools because it understands the specific e-invoice XML standards and can surface embedded machine-readable data even from hybrid PDFs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:43:38.762Z","isFirstParty":false,"canonicalSlug":"halowerk-invoice-extract-f1723ddc"}