Projekt i Public API (API 2.0)

Från september 2023 finns en endpoint i Public API (API 2.0) för att skapa projekt. Objektet projekt är ett av de mest komplexa som finns i Blikk och endpointen tillåter för tillfället att man skapar ”enklare” projekt som man sedan får komplettera med inställningar i gränssnittet. Här hittar du endpointen i vårt API.

För att underlätta hanteringen av vilka projekt som behöver kompletteras kan man 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å man kan sortera ut och komplettera innan det får sin korrekta projektkategori.

Här följer en liten lathund för hur den fungerar 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 man inte statusid så sätts kontots standardstatus.

Projektnummer

• Anger man 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 prissätta på något annat sätt via API:et så om annan prissättning ska tillämpas behöver man 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 ange om alla ska vara deltagare i projektet eller om det enbart ska vara projektledaren (och eventuell ansvarig säljare). Om det ska 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, och finns inte en sådan så sätts det till 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, ska projektet ha ett bokföringsprojekt så behöver det kompletteras med via gränssnittet.