lookup_codice_destinatario
Validate the format of an SDI recipient code or PEC address to determine the correct routing type for Italian e-invoicing and avoid transmission errors.
Instructions
Validate the format of a CodiceDestinatario (SDI recipient code) or PEC address.
Call this before build_transmission_header() to confirm the recipient routing type and that the code or PEC address is correctly formatted. At least one of codice or pec must be provided.
Routing rules:
codice is 6 alphanumeric chars (e.g. 'A1B2C3') → routing_type: 'SDI_CODE' (PA/IPA, FPA12)
codice is 7 alphanumeric chars (e.g. 'X1Y2Z3W') → routing_type: 'SDI_CODE' (B2B intermediary, FPR12)
codice is '0000000' (7 zeros) → routing_type: 'PEC'; pec_destinatario is then mandatory in build_transmission_header()
pec only (no codice) → validates email format, routing_type: 'PEC'
IPA note: 6-char PA office codes can be looked up at https://www.indicepa.gov.it. This tool performs format validation only — no live query against the SDI SOAP directory service or the IPA registry (planned for a future release).
On success returns a dict with 'routing_type', 'codice_destinatario' and/or 'pec_destinatario', and a 'note' with usage guidance. On invalid input returns {'error': ''}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| codice | No | SDI CodiceDestinatario to look up: 6-char alphanumeric for PA offices (IPA code, FPA12 B2G invoices), 7-char alphanumeric for B2B intermediaries (FPR12), or '0000000' (7 zeros) for PEC routing. IPA codes can be verified at https://www.indicepa.gov.it. | |
| pec | No | PEC address to validate format (user@domain.ext). When a PEC is provided, CodiceDestinatario must be '0000000'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||