Emetti ordini d’acquisto, approva e paga le fatture e configura il tuo spazio di lavoro.
Ricerca endpoint
Cerca nell’API acquirente
146 endpoint in 19 risorse. Cerca per percorso, metodo o ciò che vuoi fare: incolla un URL reale e i suoi id corrispondono ai parametri del percorso.
Prova
Riferimento API
L’API di Pleaxy è un’API REST con richieste e risposte in JSON. Usala per leggere e creare ordini d’acquisto e fatture e per seguirli lungo l’approvazione e il pagamento. Per concetti e guide, consulta la documentazione.
Autenticazione
Invia uno di questi due header con ogni richiesta:
X-Api-Key: <keyId>.<secret>: una chiave API, per i tuoi sistemi e agenti.Authorization: Bearer <accessToken>: la sessione di una persona che ha effettuato l’accesso, richiesta per alcune azioni come approvare e gestire le chiavi API.
Una credenziale funziona in un solo spazio di lavoro, come acquirente o come fornitore. Ogni percorso include l’id di quello spazio di lavoro come regionId; copialo in Pleaxy da Profilo aziendale → ID spazio di lavoro.
Errori
Gli errori usano codici di stato 4xx e un corpo JSON. Basa la logica su code, non sul message in inglese; messageId e params ti permettono di mostrare il messaggio nella tua lingua.
Versioni
I percorsi iniziano con la versione, /v1. Al suo interno si aggiungono nuovi endpoint, campi e valori, quindi ignora i campi che non riconosci e prevedi un valore predefinito per i valori sconosciuti, come gli stati. Le modifiche incompatibili arrivano con una nuova versione.
https://api.pleaxy.aicurl "$PLEAXY_API_BASE_URL/v1/workspaces/$WORKSPACE_ID/purchase-orders" \
-H "X-Api-Key: $PLEAXY_API_KEY"{
"statusCode": 404,
"error": "Not Found",
"message": "Invoice INV-7F3A9C21 not found.",
"code": "string",
"messageId": "string",
"params": { ... }
}Risorse
- Ordini d’acquistoGli ordini che un acquirente emette verso un fornitore: righe, importi, stato e approvazione.15 endpoint
- Richieste d’acquistoCiò che le persone chiedono di acquistare prima che esista un ordine: approvazione, controllo del budget, poi un ordine.9 endpoint
- FattureLe fatture dei fornitori agli acquirenti, dall’arrivo alla riconciliazione, all’approvazione e al pagamento.34 endpoint
- Note di creditoLe note di credito che riducono quanto deve un acquirente, e la loro applicazione alle fatture.11 endpoint
- Connessioni cloudCollegamenti in sola lettura alla fatturazione dei tuoi account presso i provider cloud.8 endpoint
- Spesa in IASpesa in modelli di IA per emittente della fattura, produttore del modello, modello e contatore, confrontata con i tuoi ordini d’acquisto.21 endpoint
- Provider IAProvider IA collegati direttamente con una chiave in sola lettura, e gli emittenti IA che puoi aggiungere come fornitori.6 endpoint
- LiquidazioneQuando ordini d’acquisto e fatture possono saltare l’approvazione manuale, e il piano del workspace.3 endpoint
- Catene di approvazioneChi approva gli ordini d’acquisto e i pagamenti delle fatture.2 endpoint
- Regole di automazioneRegole che approvano automaticamente i documenti corrispondenti, o li inviano sempre in approvazione.2 endpoint
- ApprovazioniGli ordini d’acquisto e le fatture in attesa di una tua azione.1 endpoint
- DipendentiLe persone di un workspace.1 endpoint
- WorkspaceRiepiloghi dashboard dell’attività di un acquirente o di un fornitore.1 endpoint
- Profili dell’organizzazioneIl profilo aziendale e i dati di fatturazione della tua azienda.2 endpoint
- NotificheNotifiche in-app e impostazioni dei solleciti.6 endpoint
- Chiavi APIChiavi che consentono ai tuoi sistemi di chiamare l’API senza che una persona abbia effettuato l’accesso.3 endpoint
- Sincronizzazione dei documentiMantieni il tuo sistema allineato: cosa è cambiato, e ogni documento in JSON, cXML o UBL.8 endpoint
- Evasione degli ordiniI fornitori confermano gli ordini e annunciano le spedizioni; gli acquirenti vedono entrambe le cose sull’ordine.6 endpoint
- WebhookFai inviare da Pleaxy ogni modifica al tuo endpoint HTTPS nel momento in cui avviene.7 endpoint