Documentazione tecnica

Come far arrivare i dati della tua azienda dentro myPedro, e come tirarli fuori. Oggi con i file; domani con l'API, senza passare da un foglio.

L'API non è ancora aperta ai clienti. La descrizione tecnica esiste (OpenAPI) e il sottodominio è previsto, ma le chiavi non si rilasciano ancora. Una data si pubblica soltanto quando chiavi, ambienti e supporto sono disponibili.

Cosa c'è oggi

Oggi i dati entrano e escono con i file. È meno elegante di un collegamento diretto, ma funziona il primo giorno e non richiede niente al reparto informatico del cliente.

Import di clienti, catalogo, listini e prezzi netti da Excel o CSV, con abbinamento delle colonne e anteprima prima di scrivere
Import dei clienti dalla rubrica del telefono e da un biglietto da visita fotografato
Export della nota spese nei tracciati che l'amministrazione importa già
Export dei dati dello spazio su richiesta del titolare, in qualsiasi momento

Nessuno di questi passaggi richiede l'API: sono nel prodotto e li usa una persona, non un programma.

A cosa servirà l'API

L'API è un punto di sviluppo, e serve a una cosa sola: far arrivare i dati dell'azienda senza passare dai fogli. Il gestionale o il CRM sono già la fonte di verità di clienti, listini e condizioni — copiarli a mano in un file è il punto in cui i dati invecchiano.

Cosa vorremmo importare

Anagrafiche clienti, con le condizioni e i prezzi netti che l'azienda ha già deciso
Catalogo e listini, aggiornati quando cambiano invece che una volta al trimestre
Le persone della rete e i loro perimetri

Cosa vorremmo restituire

Visite registrate, con esito e attività aperte
Chilometri dichiarati e note spese, nel formato della contabilità

Da quali gestionali

Questi sono i sistemi da cui vogliamo importare per primi, perché sono quelli che le PMI italiane usano davvero. Non sono integrazioni esistenti e non sono partner: è l'ordine in cui pensiamo di lavorarci.

TeamSystemZucchettiDanea EasyFattFatture in CloudMicrosoft DynamicsSAP Business One

Se il tuo gestionale non è in elenco, scrivicelo: l'ordine lo decide chi ce lo chiede, non noi.

Che forma avrà

REST su HTTPS, autenticazione a chiave per spazio cliente, risposte in JSON. La descrizione OpenAPI è già scritta e viaggia insieme al codice: quando apriamo, non c'è una documentazione da inventare.

# Esempio futuro — le chiavi non si rilasciano ancora
GET /v1/clienti?aggiornati_da=2026-08-01
Authorization: Bearer <chiave dello spazio>

{
  "dati": [
    { "id": "cli_…",
      "ragioneSociale": "…",
      "partitaIva": "…",
      "listino": "…" }
  ],
  "prossimaPagina": null
}

Ogni chiamata resta dentro lo spazio della sua chiave: l'isolamento fra aziende vale per l'API esattamente come per l'applicazione, sugli stessi due livelli.

Ordine, non data

Prima l'import di clienti e listini; poi la restituzione di visite e rendiconti. L'ordine può cambiare sulla base dei progetti reali: non pubblichiamo una data che non possiamo sostenere.

Se ti serve prima, dircelo sposta le priorità più di qualsiasi nostra previsione.