Portabilità

Cambiare piattaforma

Digitate il nome di un'azienda, o incollate un identificativo fiscale — in qualsiasi paese copriamo. Identifichiamo l'azienda, leggiamo la directory pubblica dove il paese ne ha una e vi diciamo cosa richiede il suo passaggio lì: un'azienda in trenta secondi, o cinquemila in un pomeriggio.

Un'azienda

Nessun account, nessuna chiave API: la pagina crea una chiave sandbox usa e getta e la dimentica quando chiudete la scheda.

Nome dell'azienda, identificativo fiscale, partita IVA o identificativo Peppol

Bastano tre lettere. I nomi sono cercati nel registro nazionale quando il paese ne pubblica uno, e sulla rete Peppol dappertutto altrove — anche un'azienda belga, italiana o britannica risponde quindi al proprio nome. Un identificativo fiscale, una partita IVA o un identificativo Peppol funziona sempre.

Molte aziende insieme

Una migrazione di piattaforma è raramente una sola azienda, e raramente un solo paese. Incollate l'elenco — nomi, identificativi fiscali, partite IVA o identificativi Peppol, uno per riga, direttamente da un foglio di calcolo — e ogni riga viene risolta come la ricerca qui sopra, quattro alla volta per non saturare nulla. Quello che torna è una tabella su cui agire: chi è davvero ogni riga, chi la instrada oggi e cosa manca ancora prima di depositare il suo passaggio nel proprio paese.

Un'azienda per riga

Poi depositatele in una sola chiamata. Il pulsante Copia il payload di import vi dà il corpo di POST /v1/companies/import/batch — fino a 500 aziende per chiamata, ognuna idempotente sul proprio identificativo, ognuna con il proprio esito, così un fallimento parziale non vi costa mai il lotto. Mettete la effectiveDate concordata sugli elementi e l'indirizzo di instradamento viene creato per quella data, non per l'istante della chiamata.

Cosa l'elenco non fa da solo

Risolvere un elenco vi dice chi sono queste aziende e cosa richiede il loro passaggio. Non invia nulla: i messaggi fra piattaforme partono all'apertura delle richieste, quindi potete guardare la tabella, correggere le tre righe incomplete e solo allora confermare.

Come funziona davvero un cambio di piattaforma

Quattro passi, gli stessi in ogni paese che copriamo — ciò che cambia è la documentazione che ognuno richiede, i termini su cui corre e se esista o meno una directory pubblica da ripuntare. La matrice paese per paese riporta le differenze; la guida francese percorre un regime dall'inizio alla fine. Questa è la forma che condividono.

Identificare il soggetto

Un identificativo — o un nome, risolto qui sopra — diventa la ragione sociale, il paese, gli identificativi nazionali, l'identificativo Peppol e, dove il paese pubblica una directory, la riga su cui instrada. Ciò che non si riesce a risolvere torna in stillNeeded invece di essere indovinato.

Aprire la richiesta

L'apertura produce l'accordo che le regole di quel paese richiedono, i suoi termini calcolati sul calendario lavorativo di quel paese e una catena di prove concatenata da hash — la prova sopravvive alla contestazione, non solo al percorso felice.

Avvisare l'altra piattaforma

Dove un paese prescrive un formato fra piattaforme — l'oggetto normalizzato e il CSV a 18 campi della Francia, per esempio — viene costruito e inviato alla piattaforma uscente, indirizzato dalla rubrica delle piattaforme autorizzate. Viene registrato con l'impronta di ciò che è stato inviato, che parta o no.

Commutare l'instradamento

Alla data di efficacia concordata — non prima — l'indirizzo di instradamento si sposta. La piattaforma uscente smette di emettere quel giorno e continua a ricevere finché il suo paese lo richiede (dodici mesi in Francia), così nulla in corso va perso.

Gli orologi appartengono al paese, non a noi

In Francia una richiesta va riscontrata entro 24 ore ed evasa entro 5 giorni lavorativi, oltre i quali il silenzio vale assenso — in entrambe le direzioni: il termine vi protegge quando siete la piattaforma entrante e vi espone quando siete quella uscente. Altri paesi fissano finestre diverse, e alcuni non ne fissano affatto: resolve restituisce il regime applicabile all'azienda cercata, e la matrice paese per paese spiega il resto.

Pilotarlo dal vostro sistema

Tutto ciò che questa pagina fa è l'API pubblica con una chiave sandbox. Le stesse chiamate, con la vostra chiave, sono quelle che usa un integratore o un agente. Sono indipendenti dal paese, salvo dove indicato:

Chiamata	Cosa fa
`GET /v1/portability/companies?q=`	Digitate un nome, ottenete l'azienda — ciò su cui gira il campo qui sopra. Prima il registro nazionale dove ne esiste uno collegato (la Francia), poi la rete Peppol; gli identificativi si risolvono su entrambi.
`POST /v1/portability/resolve`	Un identificativo in ingresso, tutto il soggetto in uscita, più ciò che il suo paese richiede.
`POST /v1/portability/requests`	Aprire la richiesta: mandato di designazione, termini, catena di prove.
`POST /v1/portability/messages`	Inviare il messaggio normalizzato fra piattaforme e conservarne la prova.
`GET /v1/portability/annuaire/{siren}`	🇫🇷 Chi instrada questo soggetto oggi, da quando, fino a quando — l'annuaire francese.
`POST /v1/portability/routing`	Spostare l'instradamento alla data concordata.
`POST /v1/companies/import/batch`	Inserire tutto l'elenco, con esito per elemento.

Parametri completi nel riferimento API, la procedura nella guida portabilità e le regole paese per paese in cambiare piattaforma in Europa.