Caricamento dati Clienti/Fornitori

Permette il caricamento di nuovi dati di clienti e/o fornitori per una data coppia item/transmitter sotto forma di CSV.

Gli header richiesti dalla chiamata sono gli header standard di TSDigital.

Il Content-Type deve essere application/json

Il body della richiesta deve avere il seguente formato:

{
  "transmitterId": "string",
  "itemId": "string",
  "document": "string",
  "documentType": "CUSTOMER" | "SUPPLIER"
}

Dove:

transmitterId: identificativo dell'item che sta caricando i dati
itemId: identificativo dell'item per il quale stanno venendo caricati i dati
document: contenuto del CSV, codificato in Base64
documentType: tipologia di documento, può essere uno di due valori
- CUSTOMER: indica che i dati caricati fanno riferimento a clienti
- SUPPLIER: indica che i dati caricati fanno riferimento a fornitori

In caso di successo, l'API risponde con il codice HTTP 200, con il seguente body:

{
  "id": "string"
}

Dove id è l'identificativo univoco dei dati appena caricati.

In caso di errore, l'API ritorna un body nel formato:

{
  "message": "string"
}

Dove message è un messaggio che indica la ragione dell'errore.

L'API può rispondere con i seguenti codici d'errore:

400: una (o più) parti della richiesta non rispettano lo schema specificato (es: header obbligatorio mancante, parametro obbligatorio del body mancante, ecc.)
401: non è stato fornito un token d'autenticazione, o il token d'autenticazione fornito è scaduto
403: l'utente che ha effettuato la richiesta non ha i permessi necessari per portarla a termine
500: si è verificato un errore inaspettato nel completare la richiesta
502: è stato impossibile completare l'upload dei dati verso il servizio che si occupa di conservare i dati