Regulatory Documents, EN 16931 E-Invoicing & Signed POD/CMR
As a European B2B Merchant of Record (MoR) for industrial print manufacturing, PrintPriceOS automates the generation of legally compliant electronic invoices (EN 16931), international waybills (Signed POD / CMR), pallet barcoding (GS1-128 SSCC-18), and event-driven SMTP Transactional Notifications.
1. European Electronic Invoicing (EN 16931)
Implemented in src/api/services/invoicing/eInvoicingService.js, the e-invoicing engine supports the two primary European structured XML mandates alongside a vector DIN A4 Commercial Invoice PDF (commercialInvoicePdfService.js):
- Spain (
Facturae 3.2.2XML):- Compliant with Ley 25/2013 and Ley Crea y Crece (
fe:Facturaenamespacehttp://www.facturae.gob.es/formato/Versiones/Facturaev3_2_2.xml). - Supports Administrative Centres (
Oficina Contable,Órgano Gestor,Unidad Tramitadora) for public/institutional publishing tenders and standard B2B NIF/CIF validation.
- Compliant with Ley 25/2013 and Ley Crea y Crece (
- Pan-European Cross-Border (
XRechnung 3.0/OASIS UBL 2.1XML):- Compliant with EU Directive 2014/55/EU and PEPPOL BIS Billing 3.0 (
urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0). - Supports Intra-Community Reverse Charge (
AE/VATEX-EU-AE) when buyer and seller reside in different EU Member States with valid VIES VAT numbers.
- Compliant with EU Directive 2014/55/EU and PEPPOL BIS Billing 3.0 (
1.1 Strict Fiscal Line-Item Segregation (Inviolable Invariant)
In compliance with PrintPriceOS commercial governance rules, Manufacturing, Packaging, and Landed Freight are strictly segregated at both the database ledger and XML line-item levels (InvoiceLine / cac:InvoiceLine). Bundling freight into unit book manufacturing prices is strictly prohibited:
| Line Item Code | UNSPSC / CPV Classification | Description in XML & PDF | Tax Category |
|---|---|---|---|
MFG_EDITORIAL_PRINT | 82121500 (Commercial Printing) | Industrial Book Manufacturing (Prepress, Plates, Paper Stock, Offset/Digital Press & Binding) | Standard or Super-Reduced Editorial VAT (4% ES Books / 21% Commercial / 0% Intra-EU Reverse Charge) |
PACK_EPAL_FEFCO | 24112700 (Pallets & Packaging) | Industrial Export Packaging (FEFCO 0201 Double-Wall Boxes, Heat-Treated ISPM-15 EPAL Pallets & Stretch Wrap) | Standard VAT / Reverse Charge |
FREIGHT_LANDED_DOCK | 78101800 (Road Freight Transport) | Dedicated Landed Freight & Tail-Lift Dock Delivery (Separated from Manufacturing) | Standard VAT / Reverse Charge |
EPAL_PALLET_COMPENSATION | 24112701 (Pallet Pool Credit) | Circular Economy EPAL Pallet Exchange / Compensation Credit (if applicable) | Credit Line / Allowance |
2. Stage 05 Logistics: Signed POD/CMR & GS1-128 SSCC-18 Labels
Implemented in src/api/services/logistics/podAndLabelsPdfService.js, the logistics document engine generates two industrial vector PDF documents required for warehouse dispatch and escrow settlement:
2.1 GS1-128 SSCC-18 Pallet Labels (DIN A6 — 105 x 148 mm / A4_SHEET_4UP)
- Endpoints:
GET /api/logistics/shipments/:id/labels/sscc-pdfandPOST /api/logistics/shipments/:id/labels/sscc-pdf - Format: Native
PDF-1.4DIN A6 (297.64 x 419.53 pt) or A4 4-UP vector pallet identification label (deliveryNotePdfService.js). - Specifications:
- High-contrast vector barcode bars encoding Application Identifier
(00)followed by the 18-digit Serial Shipping Container Code (SSCC-18) with Modulo-10 check digit validation. - Displays Shipper (Assigned Industrial Plant), Consignee (Publisher Warehouse Dock), Gross Pallet Weight (
kg), Carton Count (FEFCO 0201), Units per Carton, and ISPM-15 heat-treatment certification mark.
- High-contrast vector barcode bars encoding Application Identifier
2.2 Proof of Delivery & International CMR Waybill (DIN A4)
- Endpoint:
GET /api/logistics/shipments/:id/delivery-note/pdf - Format: Native
PDF-1.4DIN A4 (595.28 x 841.89 pt) vector delivery note and signed POD/CMR certificate (deliveryNotePdfService.js). - Escrow Settlement Trigger (
STAGE_05_DELIVERED):- When the order advances to
Stage 05: Delivered & Signed POD(POST /api/customer/orders/:orderId/stageorPOST /api/financials/escrow/:orderId/settle-on-pod), the POD document embeds the consignee's eIDAS electronic reception seal (SHA-256), GPS dock coordinates, reception timestamp, and receiver identity. - Simultaneously, the MoR Escrow ledger transitions from
FUNDS_LOCKED_ON_PROOF_APPROVALtoRELEASED_ON_SIGNED_POD, authorizing net manufacturing payout to the printhouse.
- When the order advances to
3. Automated Transactional SMTP Notifications (transactionalEmailService.js)
Implemented in src/api/services/notifications/transactionalEmailService.js, the notification engine provides decoupled SMTP delivery (compatible with Postfix/Plesk on 212.227.79.67, Amazon SES, Postmark, and SendGrid) with deterministic in-memory audit fallback (simulated: true) when running in isolated test environments.
Canonical Transactional Templates & Binary PDF Attachments
| Template Code | Trigger Event | Default Recipient | Automatic Binary Attachment(s) |
|---|
ORDER_CREATED_WIRE_INSTRUCTIONS| Checkout completed viaB2B_WIRE_TRANSFER| Buyer (FINANCE_APPROVER/ORG_ADMIN) |Proforma-Invoice-[orderId].pdf(Contains IBAN, BIC/SWIFT, and mandatory payment reference) | |IMPRIMATUR_SIGNED_ESCROW_LOCKED| 3D Soft-Proof signed (POST /soft-proof/sign-off) | Buyer + Assigned Printhouse |CERT-SP-[orderId].pdf(Cryptographic 3D Soft-Proof & Imprimatur Certificate) | |STAGE_04_DISPATCHED_LABELS_READY| Order advances toStage 04: Palletized & Dispatched| Buyer Logistics + Printhouse Dock |SSCC-Labels-[orderId].pdf(GS1-128 SSCC-18DIN A6 Pallet Labels) | |ORDER_DELIVERED_POD_RELEASED| Order reachesStage 05: Delivered & Signed POD| Buyer + Printhouse Finance |POD-CMR-[orderId].pdf+Invoice-[orderId].pdf(Signed POD & Final Commercial Invoice) |
4. API Reference: Regulatory Documents & Notifications
4.1 Download EN 16931 Electronic Invoice (Facturae 3.2.2 or XRechnung 3.0 / UBL 2.1)
- RBAC Requirement:
ORG_ADMINorFINANCE_APPROVER(requireFinanceRights).
# Download Spanish Facturae 3.2.2 XML
curl -X GET "https://control.printprice.pro/api/financials/escrow/ORD_2026_101/e-invoice.xml?format=FACTURAE_3_2_2&raw=true" \
-H "x-marketplace-token: YOUR_MARKETPLACE_TOKEN" \
-H "x-b2b-role: FINANCE_APPROVER" \
-H "x-b2b-member-id: MEM_2026_0003" \
-o Facturae_ORD_2026_101.xml
# Download Pan-European XRechnung 3.0 / UBL 2.1 XML
curl -X GET "https://control.printprice.pro/api/financials/escrow/ORD_2026_101/e-invoice.xml?format=XRECHNUNG_3_0&raw=true" \
-H "x-marketplace-token: YOUR_MARKETPLACE_TOKEN" \
-H "x-b2b-role: FINANCE_APPROVER" \
-H "x-b2b-member-id: MEM_2026_0003" \
-o XRechnung_UBL_ORD_2026_101.xml
4.2 Download Vector POD/CMR, Carrier Protocol, and SSCC-18 Pallet Labels
# 1. Signed Proof of Delivery / CMR Waybill PDF (DIN A4)
curl -sS "https://control.printprice.pro/api/logistics/shipments/SHP-2026-0101/delivery-note/pdf" \
-H "x-marketplace-token: YOUR_MARKETPLACE_TOKEN" \
-o POD_CMR.pdf
# 2. GS1-128 SSCC-18 Pallet Labels PDF (DIN A6 or A4_SHEET_4UP)
curl -sS "https://control.printprice.pro/api/logistics/shipments/SHP-2026-0101/labels/sscc-pdf?format=A6" \
-H "x-marketplace-token: YOUR_MARKETPLACE_TOKEN" \
-o SSCC_Labels.pdf
# 3. Official DIN A4 Carrier Integration Protocol PDF
curl -sS "https://control.printprice.pro/api/logistics/carrier-protocol/pdf" \
-H "x-marketplace-token: YOUR_MARKETPLACE_TOKEN" \
-o Carrier_Protocol_A4.pdf