Mobigo REST API

Låt era andra system läsa och skriva i Mobigo — uppdrag med material och tid i ett enda anrop

Ett REST-API på er egen server, bredvid Mobigo. Andra system skapar uppdrag, rapporterar tid och material, och läser kunder, artiklar, offerter, ordrar och avtal. Allt går genom Mobigos egna regler — nummerserier, prissättning, behörigheter och valideringar.

Hela uppdraget i ett anrop

Uppdrag med material, tid, extrafält och dokument skapas i en enda begäran och en transaktion.

Läs det som ändrats

Alla register — uppdrag, kunder, artiklar, offerter, ordrar, avtal, projekt, objekt, kontakter och rader. Med urval på ändringsdatum, så en synk bara hämtar det som är nytt i stället för allt varje gång.

Era egna fält

Extrafälten som är definierade i Mobigo går att både läsa och skriva.

Så ser API:et ut i Swagger

Varje anrop, varje fält och färdiga exempel — öppet på webben, utan installation.

Exempel på vad ni kan göra

Ett urval, inte hela listan. API:et täcker uppdrag, kunder, artiklar, leverantörer, offerter, ordrar, avtal, projekt, objekt, kontakter, adresser, tid och material.

Det ni vill göraAnropet
Skapa ett uppdrag med material, tid, extrafält och bilagor — i en enda begäran och en transaktion. POST /v1/tasks
Skapa en order med sina rader. Artikelnummer, antal, priser och leveransdatum följer med i samma anrop. POST /v1/orders
Lägga upp en kund med kontaktpersoner. Går någon kontakt fel skapas ingen kund alls. POST /v1/customers
Hämta det som ändrats sedan förra körningen — på vilken resurs som helst, så en synk slipper läsa om allt varje gång. GET /v1/tasks?modifiedSince=…
Byta status på ett uppdrag genom Mobigos egna övergångsregler. POST /v1/tasks/{nr}/status
Ta reda på vad era egna fält heter och vilka värden de tillåter, innan ni skriver till dem. GET /v1/customers/extra-fields
Hela API-ytan i Swagger → Alla anrop, varje fält och färdiga exempel på vad ni skickar in och får tillbaka. Integratörsguiden → Kom igång, autentisering, uppdrag, ordrar, extrafält och felkoder. Finns även på engelska.

Båda är öppna och kräver ingen installation. Samma sidor följer med produkten och visas då mot er egen server.

Ett uppdrag med material och tid

POST /v1/tasks
Authorization: Bearer mk_...
Idempotency-Key: order-4711

{
  "customerNr": "10003",
  "taskText": "Servicebesök enligt avtal",
  "extraFields": { "Visma_Ordernr.": "VO-4711" },
  "materials": [ { "productNr": "A10001", "quantity": 3 } ],
  "times":     [ { "timeType": "Normaltid", "hours": 1.5 } ]
}

201 Created
{ "nr": "U039079",
  "materials": [ { "id": 44821, "productNr": "A10001" } ],
  "times":     [ { "id": 100636, "timeType": "Normaltid" } ] }

Så kommer ni igång

  1. Begär licens och installationspaket i formuläret nedan.
  2. Vi skickar paketet tillsammans med licensnyckeln.
  3. Kör installationsskriptet på samma server som Mobigo. Det hittar Mobigo, väljer rätt motor för er version, ordnar certifikat och registrerar tjänsterna.
  4. Ange licensnyckeln i adminytan och skapa er första integrationsnyckel.
  5. Prova anropen direkt i Swagger-ytan, och läs integratörsguiden som följer med.

Begär licens och installationspaket

Vi skickar installationspaketet tillsammans med licensnyckeln. Pris enligt offert — berätta vad ni vill integrera, så återkommer vi med förslag och pris.