Flusso di Interazione B2B

Scenario

Lo scenario B2B descrive l’integrazione tra due o più aziende (tipicamente cliente–fornitore o partner commerciali) che devono scambiarsi dati e documenti in modo strutturato, affidabile e tracciato, riducendo attività manuali e duplicazioni.

L’obiettivo principale è consentire a un sistema esterno (ERP, piattaforma B2B, middleware, marketplace) di interagire con TeamSystem per supportare processi end‑to‑end quali:

• pubblicazione e aggiornamento dei cataloghi;
• ricezione e gestione degli ordini;
• scambio di documenti commerciali (DDT, fatture);
• sincronizzazione di stati, avanzamenti e esiti.

Lo scenario B2B non si limita alla singola API o al singolo documento, ma copre l’intero flusso operativo, dalla fase di onboarding del partner fino alla gestione dei documenti fiscali e logistici.

• Contesto tipico
  

  • Azienda A utilizza TeamSystem come ERP amministrativo/gestionale.
  • Azienda B utilizza un sistema esterno (ERP, gestionale custom, piattaforma di integrazione).

---

Casi d'uso B2B

Per ciascun caso d’uso viene indicato l’approccio consigliato tra Smart Web API e Web API tradizionali. L’indicazione è funzionale e orientata alla semplicità di integrazione; il dettaglio tecnico e i riferimenti alle API saranno collegati in una fase successiva.

• Caso d’uso 1 – Sincronizzazione catalogo commerciale
  

Attori: • Sistema partner B2B • TeamSystem

Descrizione: Il partner recupera da TeamSystem il catalogo articoli (articoli, listini, unità di misura, anagrafiche collegate) per allineare il proprio sistema o per pubblicarlo verso clienti o marketplace.

Allineamento API

• Smart Web API – Consigliate per letture strutturate e standardizzate del catalogo; per ridurre la complessità di mapping e gestione versioni.
• Web API tradizionali utilizzabili in scenari avanzati o personalizzati. Risultato: Cataloghi sincronizzati ed eliminazione di aggiornamenti manuali.

---

• Caso d’uso 2 – Ricezione ordine cliente da sistema esterno
  

Attori: • Sistema partner B2B • TeamSystem

Descrizione: Un ordine cliente viene creato su un sistema esterno (portale ordini, marketplace B2B) e trasmesso a TeamSystem per la gestione commerciale, logistica e amministrativa.

Allineamento API

• Smart Web API – Consigliate per l’inserimento guidato dell’ordine; per la gestione delle validazioni funzionali standard.
• Web API tradizionali necessarie solo in casi di logiche custom non coperte. Risultato: Ordini acquisiti automaticamente e piena coerenza tra canali di vendita e gestionale.

---

• Caso d’uso 3 – Scambio documenti logistici (DDT)
  

Attori: • Sistema partner B2B • TeamSystem

Descrizione: I documenti di trasporto generati vengono scambiati tra i sistemi per garantire l’allineamento dei flussi logistici e lo stato delle spedizioni.

Allineamento API

• Smart Web API – Consigliate per la creazione e la consultazione dei documenti; per mantenere coerenza con il processo logistico standard.
• Web API tradizionali utilizzabili per integrazioni legacy già esistenti. Risultato: Visibilità condivisa delle spedizioni e riduzione delle incongruenze operative.

---

• Caso d’uso 4 – Fatturazione e scambio documenti fiscali
  

Attori: • TeamSystem • Sistema partner B2B

Descrizione: La fattura emessa in TeamSystem viene resa disponibile al partner per la contabilizzazione, l’archiviazione o la distribuzione verso clienti e sistemi terzi.

Allineamento API

• Smart Web API – Consigliate per la gestione dei documenti fiscali; per garantire coerenza normativa e ridurre errori di integrazione.

• Web API tradizionali da utilizzare solo se non ancora disponibile copertura Smart. Risultato: Allineamento automatico dei documenti fiscali e riduzione dei tempi di riconciliazione.

• Sintesi CRUD – Gestione Fattura via Smart WebAPI
  

Qui trovi i riferimenti alle APIreference .

La gestione della fattura nelle Smart WebAPI si articola secondo un modello CRUD completo, integrato con validazione e gestione asincrona dei processi.

• CREATE – Creazione Fattura vai all'esempio

  • La creazione avviene tramite endpoint REST in modalità asincrona
  • Il client invia un payload JSON basato su InvoiceDTO Smart
  • Le principali fasi sono:
    • Invio richiesta batch
    • Validazione formale e semantica dei dati
    • Mapping verso il modello del gestionale target
    • Invio asincrono al backend ERP
    • Restituzione GUID batch
    • Monitoraggio stato elaborazione

• READ – Consultazione fattura vai all'esempio

  • Recupero tramite endpoint:
    • GET by id singolo documento
    • GET lista documenti
  • Caratteristiche:
    • Operazione sincrona
    • Supporto a filtri e paginazione
    • Restituzione del DTO completo (header, righe, metadati)

• UPDATE – Aggiornamento Fattura vai all'esempio

  • Endpoint: PUT by id
  • Consente la modifica di fatture esistenti:
    • Solo se il documento è in stato modificabile (es. non contabilizzato)
  • Processo:
    • Invio payload con i dati aggiornati
    • Validazione coerenza dati
    • Mapping verso DTO gestionale
    • Invio sincrono o asincrono a seconda del backend

• DELETE – Cancellazione Fattura vai all'esempio

  • Endpoint: DELETE by Id
  • Consente la cancellazione del documento:
    • Solo se non contabilizzato o non vincolato a processi fiscali
  • Comportamento:
    • Eliminazione logica o fisica secondo le regole ERP

• VALIDATE vai all'esempio

  • Endpoint: POST
  • Permette:
    • Controllo dei dati senza creazione effettiva
    • Verifica preventiva di errori su:
      • campi obbligatori
      • coerenza fiscale
      • struttura righe