Esempi di API weclapp: fatture non pagate, giacenze e ordini, con o senza codice

L’API di weclapp in due minuti

weclapp ha un’API REST che copre quasi tutto ciò che vedi nell’applicazione: articoli, clienti e altri soggetti, offerte, ordini di vendita, fatture, spedizioni e giacenze di magazzino. Ogni azienda ha il proprio indirizzo:

https://your-company.weclapp.com/webapp/api/v2/

Ogni richiesta porta con sé un token API nell’header AuthenticationToken. Il token appartiene a un utente weclapp e ha i diritti di quell’utente. Lo crei nelle tue impostazioni personali di weclapp.

Gli elenchi si trovano sotto il nome dell’entità, come /salesInvoice o /article. Pochi parametri di query fanno quasi tutto il lavoro:

Parametro	A cosa serve	Esempio
<field>-eq e altri operatori	Filtrare per un campo	paymentStatus-eq=OPEN
properties	Restituire solo i campi scelti	properties=invoiceNumber,dueDate,grossAmount
page e pageSize	Scorrere elenchi lunghi pagina per pagina	page=2&pageSize=100
/count	Contare invece di elencare	/salesInvoice/count?paymentStatus-eq=OPEN

Consulta il riferimento interattivo dell’API nel tuo account weclapp per conoscere esattamente i campi e gli operatori disponibili.

Esempio 1: fatture aperte

GET /webapp/api/v2/salesInvoice?paymentStatus-eq=OPEN&properties=invoiceNumber,invoiceDate,dueDate,grossAmount
AuthenticationToken: <your token>

weclapp distingue stati di pagamento come OPEN, PAID e NO_OPEN_ITEM. Per trovare le fatture scadute devi confrontare dueDate con la data di oggi nel tuo codice. weclapp salva le date come timestamp, quindi convertile prima di mostrarle a qualcuno.

Esempio 2: quante fatture aperte?

GET /webapp/api/v2/salesInvoice/count?paymentStatus-eq=OPEN

La risposta è un solo numero. Perfetto per una dashboard o un controllo veloce.

Esempio 3: ordini di vendita recenti

GET /webapp/api/v2/salesOrder?properties=orderNumber,orderDate,status,netAmount&pageSize=50

Aggiungi un filtro su orderDate o status per restringere l’elenco. Per il fatturato per cliente dovresti combinare gli ordini con i dati dei soggetti e raggruppare i risultati da solo.

Esempio 4: livelli di giacenza

GET /webapp/api/v2/warehouseStock?pageSize=100

Le giacenze sono salvate per articolo e magazzino. Per rispondere a “quali articoli finiranno presto?” ti serve anche lo storico delle vendite, e così diventa un piccolo progetto sui dati.

Dove l’API diventa costosa per un’azienda

Le richieste qui sopra sono semplici. Il lavoro che ci sta intorno no:

• Combinare i dati. La maggior parte delle domande aziendali mette insieme più entità, come fatture, soggetti e pagamenti.
• Paginazione e limiti. Gli elenchi lunghi richiedono cicli, nuovi tentativi e gestione degli errori.
• Proteggere il token. Script, fogli di calcolo e strumenti di integrazione tendono ad accumularne copie.
• Scrivere in sicurezza. Un PUT sull’articolo sbagliato modifica i tuoi dati reali. Non esiste un “controlla prima” integrato.
• Manutenzione. Ogni nuova domanda significa nuovo codice, e chi l’ha scritto l’anno prossimo potrebbe non esserci più.

Le stesse risposte senza codice

Steward usa la stessa API di weclapp, ma il tuo team fa domande in linguaggio naturale. Steward conosce già entità, campi e filtri di weclapp, quindi costruisce le richieste, scorre le pagine dei risultati e li combina.

Invece di…	Chiedi a Steward
Esempio 1	“Quali fatture sono scadute, e per quale importo totale? Raggruppale per cliente.”
Esempio 2	“Quante fatture sono ancora aperte?”
Esempio 3	“Confronta il fatturato degli ordini per cliente di questo trimestre con quello del trimestre scorso.”
Esempio 4	“Quali articoli finiranno entro due settimane al ritmo di vendita attuale?”

Rispetto a uno script cambiano tre cose:

1. Il token resta protetto. Un amministratore collega weclapp una sola volta. Il token viene salvato cifrato e non viene mai mostrato. E non viene mai dato nemmeno all’IA. Il codice che Steward scrive per un’analisi gira senza le tue credenziali.
2. Ruoli nel progetto. I Visualizzatori seguono i risultati, i Collaboratori usano le connessioni configurate e preparano modifiche, i Responsabili approvano. I membri invitati non necessitano di un accesso separato alla connessione.
3. Per approvare o rifiutare modifiche serve il ruolo di Responsabile nel progetto della proposta. I collaboratori possono preparare modifiche e verificarne i dettagli. Prima dell’esecuzione vengono ricontrollati l’accesso attuale dell’esecutore al progetto e la connessione attiva.

Quando usare direttamente l’API

Usa direttamente l’API per le integrazioni permanenti, come sincronizzare un negozio online, collegare un fornitore logistico o costruire la tua applicazione. Usa Steward per le centinaia di domande che il tuo team fa tra un’integrazione e l’altra. Raramente quelle domande giustificano uno sviluppatore, uno script e un piano di manutenzione.

Inizia ora

Collega weclapp, attivalo per un progetto e fai una delle domande qui sopra in modalità Sola lettura. Per un confronto più ampio delle opzioni di IA, leggi Come parlare con weclapp usando l’IA.