Hvordan fungerer det med API og integrasjoner i SmartCraft Spark?

Det finnes et API knyttet til SmartCraft Spark som kan brukes til å utveksle data med annen programvare.

Innhold:

1. Slik oppretter du et API i SmartCraft Spark
2. Disse dataene kan du få via Integrasjon/API med SmartCraft Spark
3. Kort oppsummering av data

______________________________________________________________________________

1. a) For å aktivere API-integrasjonen klikker du på initialene dine (nederst til venstre) og velger «Integrasjoner»

OBS! Er dere flere brukere i selskapet? – Det er kun kontoeieren som kan gjøre dette dersom dere er flere brukere på samme firmakonto i SmartCraft Spark.

1. b) Klikk deretter på «nye API-påloggingsinformasjoner» - den grønne knappen øverst til høyre.

• Fyll deretter inn API Informasjon navn

  

• Deretter får du generert en klient-ID, samt et passord. OBS! Lagre disse opplysningene på et sikkert sted før du trykker «Lukk».
   

  
   

• Du kan opprette flere integrasjoner ved behov, og du vil se dem i listen din.

  

2. Nedenfor har du alt av data du kan hente ut via et API med SmartCraft Spark. Når et "API-token" er opprettet, er dette dataen som vil bli gjort tilgjengelig. Dataen kan eventuelt utvides etter hvert.

Dersom du har noen spørsmål om dette, ber vi deg ringe eller sende e-post:

📞 09808

✉️ info@smartcraftspark.com

Data via API med SmartCraft Spark

Tenant metadata: 

    tenant_name

    tenant_id

    tenant_adress

    tenant_zip

    tenant_city

    tenant_license_name

    tenant_amount_of_users

Offer Tenant Metadata

    open_offers_value_total (per tenant)

    accepted_offers_value_total (per tenant)

    average_value_accepted_offers (per tenant)

    median_value_accepted_offers (per tenant)

Offer Metadata

    offer_id

    offer_name

    status (Draft, Sent, Accepted, Rejected, Expired, Cancelled)

    offer_accepted_by_name(if accepted)

    offer_accepted at(DDMMYYYY HHMM, if accepted)

    created_at

    valid_until

    created_by (Full name or user ID)

    caseworker_name

    offer_work_cost_value

    offer_work_sum_hours

    offer_material_cost

    offer_margin_value

    offer_margin_percentage

    offer_sales_price_excl VAT

    offer_sales_price_incl VAT

Offer Customer Information

    customer_org_number

    customer_type_private/company

    customer_name

    customer_id

    customer_country

    customer_address

    customer_zip

    customer_city

    customer_email

    customer_phone

Offer Worksite Information

    worksite_description

    worksite_country

    worksite_address

    worksite_zip

    worksite_city

Offer Line Items

    item_name

    brand

    unit_type

    quantity

    unit_cost

    total_cost

    surcharge_percentage

    surcharge_amount

    unit_price

    discount_percentage

    discount_amount

    unit_sales_price

    total_sales_price

    margin_percentage

    margin_amount

    item_type (e.g., text, piece, pkg, etc.)

If possible, same items should be listed only once, but then with correct QTY. 
Other offer data

    pdf_attachment (if included in offer)

    message_content 

Sammendrag (tilgjengelige datafelt) 

Tilbudets metadata, inneholder:

• ID, navn, tilbudsstatus, saksbehandlers navn, opprettet dato, opprettet av
• Akseptert (når), akseptert av, gyldig til
• Margin (kr), margin (%), materialkostnad, arbeidskostnad, arbeidstimer
• Salgspris (eks. mva.), salgspris (inkl. mva.)
• Melding (innhold), vedlegg

Kundedata (tilbudets «kunde»), inneholder:

• ID, navn, type, e-post, telefonnummer
• Adresse, postnummer, poststed, land, organisasjonsnummer

Arbeidsplassdata («Tilbudets arbeidsplass»), inneholder:

• Navn, adresse, postnummer, poststed, land

Vare data («Tilbudets varer/artikler»), inneholder (per varelinje/artikkellinje):

• Artikkelnavn, artikkeltype, varemerke, produktnummer (El-nummer)
• Antall, enhetstype, enhetskostnad, enhetspris, enhetssalgspris
• Total kostnad, total salgspris, margin (kr), margin (%)
• Rabatt (kr), rabatt (%), påslag (kr), påslag (%)