# Ordine, ricevimento, DDT: un matcher a tre vie per le fatture passive in Business Central

> Il fornitore scrive il numero del DDT in fattura, spesso con descrizioni in tedesco. Ho costruito in Business Central un matcher che parte da quel riferimento, abbina ogni riga a un ricevimento registrato e fa passare solo le fatture pulite. Testato end to end su dati demo, con i limiti dichiarati.

Ogni fattura elettronica è un XML strutturato, con numero d'ordine, DDT e una riga per articolo. Eppure in molti uffici acquisti qualcuno confronta ancora a occhio quantità e prezzi con il ricevimento.

Ho costruito un matcher che fa questo confronto dentro Business Central. Fa parte dell'Italy Inbound Desk, un'estensione che ho sviluppato e testato end to end su dati demo in un sandbox.

## Cosa fa già Business Central standard

- Dal 2026 release wave 1 una fattura d'acquisto si può abbinare a più righe d'ordine e di ricevimento registrate. Ci sono l'azione **Get Order Lines** e la pagina **Matched Order Lines**.
- Il **Payables Agent** propone l'abbinamento all'ordine per le bozze di fattura in arrivo. Business Central controlla quantità e ricevimenti e avvisa se la differenza di prezzo supera la **E-Document Matching Difference %**.
- Il vecchio abbinamento Copilot tra righe di e-document e righe d'ordine è deprecato. Secondo Microsoft era validato solo in inglese.

Cosa manca per l'Italia:

- **La fatturazione elettronica italiana in Business Central non usa ancora il framework E-Documents.** Microsoft indica il passaggio come pianificato per il 2027 release wave 1.
- **La ricerca dell'ordine è un confronto esatto sul numero d'ordine.** Il riferimento al DDT, che i fornitori italiani compilano più spesso di ogni altro, non viene usato.
- **L'abbinamento delle righe richiede lo stesso numero articolo e la stessa unità di misura.** Prima qualcuno deve riconoscere l'articolo. È il passaggio difficile quando il fornitore scrive in tedesco e l'anagrafica è in italiano.

## Come decide il matcher

**1. Restringe la ricerca con i riferimenti in fattura.**
- Se la fattura riporta `DatiDDT`, il matcher guarda solo i ricevimenti con quel numero di DDT del fornitore (il campo *Vendor Shipment No.*). Una fattura differita con più DDT apre tutti i ricevimenti di quei DDT.
- Se il DDT manca, usa `DatiOrdineAcquisto` e guarda i ricevimenti di quell'ordine.
- Se nessuno dei due funziona, considera tutte le righe ricevute e non ancora fatturate del fornitore.

**2. Dà un punteggio a ogni coppia riga fattura / riga ricevimento.**
- Se il codice articolo del fornitore (`CodiceArticolo`) è noto come riferimento articolo o codice fornitore, l'abbinamento è certo.
- Altrimenti confronta le parole. Il testo della riga viene confrontato con il testo del ricevimento, con la descrizione dell'articolo e con tutte le traduzioni dell'articolo. Due parole con le stesse prime cinque lettere contano come uguali: così "trasp." trova "trasparente".
- Quantità aperta identica e prezzo in tolleranza danno punti in più. Ogni riga di ricevimento si usa una volta sola.

**3. Applica la tolleranza.**
- La quantità deve coincidere. Il prezzo può scostarsi al massimo del 2 %.
- Se tutte le righe sono pulite, la fattura è **Matched**. Se alcune righe sono abbinate ma con differenze, va in **Needs Review**. Se non si abbina nulla, resta **Unmatched**.

**4. Crea la fattura d'acquisto dalle righe di ricevimento.** Le righe nascono con la logica standard di Business Central per prelevare i ricevimenti. Poi il matcher imposta quantità e prezzo della fattura elettronica e riporta il numero fattura del fornitore.

Due controlli stanno davanti a tutto: una partita IVA del fornitore sconosciuta ferma la fattura come **Unknown Vendor**, e lo stesso file SDI importato due volte viene rifiutato.

## Cosa ha mostrato il test

Il test end to end importa sei file FatturaPA e verifica i risultati via API. Tutti i 31 controlli sono passati, comprese le altre parti del desk (integrazioni TD16–TD19 e ponte intercompany).

**Una fattura pulita.** Riferimento all'ordine e al DDT-1187, tre righe:
- 40 pallet EPAL a 9,50 €, abbinati con il codice articolo del fornitore
- 24 rotoli di film estensibile a 18,40 €
- 500 angolari in cartone a 0,32 €

Film e angolari sono stati abbinati per descrizione, dentro i ricevimenti del DDT. Stato: Matched. La fattura d'acquisto è uscita con esattamente quelle quantità, quei prezzi e il numero fattura del fornitore. Un secondo tentativo è stato rifiutato.

**Una fattura difficile.** Nessun riferimento, righe in tedesco:
- "Klebeband braun 50 mm", 100 pezzi a 2,10 €
- "Stretchfolie transparent 23my", 10 pezzi a 19,95 €

In Business Central gli articoli si chiamano "Nastro adesivo avana 50 mm" e "Film estensibile trasparente 23 micron". Il matcher li ha trovati lo stesso, attraverso le traduzioni tedesche degli articoli.

E ha trovato due problemi. Ricevuti 120 rotoli di nastro, fatturati 100. Il film fatturato a 19,95 € contro 19,00 € d'ordine, cioè il 5 % in più. Stato: Needs Review. Dopo la revisione la fattura d'acquisto ha preso i 100 rotoli al prezzo fatturato, e gli altri 20 sono rimasti aperti sul ricevimento.

## Limiti, onestamente

- **Confronta parole, non le capisce.** L'abbinamento tedesco ha funzionato perché le traduzioni degli articoli esistono. Senza traduzioni la riga resta non abbinata: è l'esito giusto, ma significa più lavoro manuale.
- **Il numero di DDT deve arrivare in Business Central.** Se al ricevimento nessuno registra il numero del DDT del fornitore, il primo filtro non serve e si passa all'ordine.
- **Niente conversione di unità di misura**, e niente abbinamento per trasporto e spese accessorie: quelle righe vanno in revisione.
- **La tolleranza è una regola fissa**, uguale per tutti i fornitori. Un ufficio acquisti vero la vorrà per fornitore o per categoria.
- **Solo dati demo.** Sei fatture dimostrano la logica, non il tasso di errore su una casella reale. Più DDT sulla stessa fattura sono gestiti nel codice, ma il test copre un solo DDT.
- **Sta fuori dal framework E-Documents**, come oggi la fatturazione elettronica italiana in Business Central, e dovrà seguirla quando Microsoft porterà l'Italia lì.

Ogni fattura non pulita la decide una persona. È una scelta di progetto, non una limitazione temporanea.

## Per approfondire

Le fatture estere che non passano da SDI: [Il desk delle integrazioni TD16–TD19](https://karrenberg.it/blog/integrazioni-td16-td19-autofatture-business-central). Gli errori da evitare prima dell'invio: [Scarti SDI: i codici di errore più comuni](https://karrenberg.it/blog/scarti-sdi-codici-errore-business-central).

## Il vostro ufficio acquisti ha lo stesso problema?

Se confrontate ancora DDT e ricevimenti a mano, mi interessa sapere come lo fate oggi. [Parliamo del tuo problema](https://karrenberg.it/#contatto). Di solito rispondo entro due giorni lavorativi.

## Fonti

- Microsoft Learn, Match purchase invoice drafts to purchase orders: https://learn.microsoft.com/en-us/dynamics365/business-central/match-purchase-invoice-drafts-to-orders
- Microsoft Learn, release plan 2026 wave 1, Match purchase invoices to multiple order and receipt lines: https://learn.microsoft.com/en-us/dynamics365/release-plan/2026wave1/smb/dynamics365-business-central/match-purchase-invoices-multiple-order-receipt-lines
- Microsoft Learn, Map e-documents to purchase order lines with Copilot (deprecazione, solo inglese): https://learn.microsoft.com/en-us/dynamics365/business-central/map-edocuments-with-copilot
- Microsoft Learn, Italy local functionality (roadmap E-Documents/SDI): https://learn.microsoft.com/en-us/dynamics365/business-central/localfunctionality/italy/italy-local-functionality
- Microsoft Learn, Electronic invoicing FAQ: https://learn.microsoft.com/en-us/dynamics365/business-central/faq-electronic-invoicing
- FatturaPA, documentazione del formato (DatiDDT, DatiOrdineAcquisto, CodiceArticolo): https://www.fatturapa.gov.it/it/norme-e-regole/documentazione-fattura-elettronica/formato-fatturapa/

## Leggi anche

- [Intercompany tra società italiane: perché la stessa fattura arriva due volte e come un ponte IC–SDI in Business Central evita i doppioni](https://karrenberg.it/blog/intercompany-sdi-gruppo-iva-doppie-fatture-business-central)
- [Fattura elettronica: il difficile è riceverla. Un assistente AI per le fatture passive in Business Central](https://karrenberg.it/blog/codifica-fatture-passive-ai-business-central)
- [Split payment e fatture verso la PA: CIG, CUP, codice ufficio ed esigibilità S, cosa controllare in Business Central](https://karrenberg.it/blog/split-payment-fatture-pa-cig-cup-business-central)

---
Simon Milos Karrenberg · https://karrenberg.it/blog/matcher-ordine-ricevimento-ddt-fatture-passive-business-central
