Visma Tid Pro

API - Projekt

I API:et finns det en endpoint för att skapa projekt. Objektet Projekt är ett av de mest komplexa som finns i Visma Tid Pro och endpointen tillåter för tillfället att du skapar ”enklare” projekt som du sedan får komplettera med inställningar i gränssnittet. Här hittar du information om endpointen i vår API-dokumentation.

För att underlätta hanteringen av vilka projekt som behöver kompletteras kan du med fördel skicka in ett prefix i projektets titel (exempelvis Kompletteras -) eller ange en specifik projektkategori för projekt som kan behöva kompletteras i gränssnittet så du kan sortera ut och komplettera innan det får sin korrekta projektkategori.

Här nedan finns en lathund över funktioner och vad som är möjligt att göra med befintlig endpoint:

Obligatoriska fält

Fält som är obligatoriska är Title, ContactId och ResponsibleId.
Anger du inte statusid så sätts kontots standardstatus.

Projektnummer

Anger du inte projectNumber sätt nästa lediga projektnummer som finns angett i kontot.
Det finns endpoints för att hämta nästa lediga projektnummer samt nästa lediga projektnummer i ett samlingsprojekt.
I svaret tillbaka på ett skapat projekt visas nästa lediga projektnummer om ytterligare projekt ska skapas direkt därpå.

Prissättning

Projektet som skapas får alltid Löpande prissättning, med prissättningen Timpris per tidsartikel.
Projektet får Standardprislista, men om kunden har en avvikande prislista på kontaktkortet så kommer denna sättas istället. Det går inte att prissätta på något annat sätt via API:et, så om någon annan prissättning ska tillämpas behöver du komplettera med det i gränssnittet.

Projektledare och ansvarig säljare

Id på projektledare är obligatoriskt.
Ansvarig säljare går inte sätta via API:et, men sätts per automatik till den person som är kundansvarig på kundkortet om det finns någon.

Deltagare

Det går att ange om alla ska vara deltagare i projektet eller om det enbart ska vara projektledaren och eventuell ansvarig säljare.Ska det vara fler deltagare behöver dessa läggas till via gränssnittet.
Att välja alla som deltagare i ett samlingsprojekt gör att alla samlingsprojektdeltagare blir medlemmar i projektet.

Kundens referens och Vår referens

Inte obligatoriska fält, men om Vår referens (OurReference) lämnas tomt kommer det sättas till namnet på den som är ansvarig säljare. Finns det ingen sådan så sätts namnet på den som är projektledare.

Bokföringsprojekt

Projekt som skapas via API:et får inget bokföringsprojekt per automatik oavsett om den inställningen är på i kontot eller inte. Ska projektet ha ett bokföringsprojekt så behöver det kompletteras via gränssnittet.