Dokumentation · Sverige · SEK

Offert-API för containerförfrågningar

Använd API:t för att förbereda och skicka en kunds offertförfrågan för ett projekt i Sverige. Kunden ska först godkänna överföringen av sina uppgifter. API:t kräver varken konto eller API-nyckel.

Anslutning och gränser

Använd samma adress för att läsa kontraktet och skicka en förfrågan. Landet i adressen styr språk, valuta och mottagning. Fältnamn och kodvärden är gemensamma för länderna och ska skickas exakt som de står i kontraktet.

Adress

https://containerfjord.com/api/agents/v1/se/devis

GET
Läs kontrakt, schema och exempel.
POST
Skicka en förfrågan med kundens samtycke.
Content-Type
application/json, UTF-8
Storlek och lästid
Högst 32 KiB och 10 sekunder för att läsa begärans kropp.
Öppna det fullständiga JSON-kontraktet

Kundens samtycke före en förfrågan

Visa följande text för kunden och invänta ett uttryckligt godkännande innan du skickar uppgifterna. Förfrågan överförs via Quotbox till högst fem registrerade företag. Samtycket gäller det aktuella projektet.

Jag godkänner att ContainerFjord överför min förfrågan och mina kontaktuppgifter via Quotbox till högst 5 registrerade företag som kan lämna offerter för mitt projekt i Sverige. Samtycket gäller inte reklam.

Skicka därefter consentement som true och consentementQuotboxAgent som quotbox-marketplace-v1. Ett exempelvärde i dokumentationen ersätter inte kundens godkännande.

Fält och villkor

Fälten nedan ska finnas med i varje förfrågan. Skicka antal som heltal och samtycke som ett booleskt värde. Extra fält som saknas i schemat avvisas.

På en smal skärm kan du rulla tabellen i sidled.

Obligatoriska fält för en offertförfrågan
FältUppgiftVärde eller villkor
familleProjektachat = sjöcontainer, stockage = förvaring, frigorifique = kylcontainer, amenage = inredd container, baseVie = personalutrymmen eller byggbod.
modeKöp eller hyraachat = köp, location = hyra.
formatStorlek20DRY, 40DRY, 40HC eller 20HC. Använd aDefinir om storleken är okänd, eller autre för ett annat format.
quantiteAntalEtt heltal mellan 1 och 50.
codePostalPostnummer i SverigeFem siffror, med eller utan mellanslag. Exempelvis 11120 eller 111 20. Första siffran ska vara 1–9.
prenomFörnamn1–80 tecken. Fältet får inte bestå enbart av blanksteg.
nomEfternamn1–80 tecken. Fältet får inte bestå enbart av blanksteg.
emailE-postadressEn giltig e-postadress, 6–254 tecken.
telephoneKundens telefonnummerHögst 40 tecken. Vid mottagning via Quotbox krävs ett giltigt nummer med minst sex siffror.
consentementKundens godkännandeDet booleska värdet true efter kundens uttryckliga godkännande.
consentementQuotboxAgentSamtyckesversionDen exakta versionen i JSON-kontraktet, för närvarande quotbox-marketplace-v1.

Villkor som beror på projektet

Fler uppgifter om projekt och leverans

Du kan komplettera med skick (etat), ort (commune), önskat datum (dateSouhaitee), tillfart (acces), lyftmöjlighet (levageSurPlace) och anslutningar för el, vatten och avlopp (raccordElec, raccordEau, raccordAssainissement). Företagsnamn anges i societe och övriga önskemål i precisions, högst 2 000 tecken.

Det fullständiga schemat anger alla tillåtna kodvärden, fältlängder och kombinationer. Om de utelämnas får etat värdet peuImporte, regimeFroid värdet aDefinir och acces värdet aVerifier.

JSON-exempel för köp av en container

Exemplet visar en sjöcontainer på 20 fot till Stockholm. Ersätt exempeluppgifterna med kundens uppgifter och kontrollera samtycket före ett verkligt anrop. Skicka JSON-objektet som kropp i en POST-begäran.

{
  "famille": "achat",
  "mode": "achat",
  "format": "20DRY",
  "quantite": 1,
  "codePostal": "11120",
  "commune": "Stockholm",
  "prenom": "Test",
  "nom": "Example",
  "email": "test\u0040example.com",
  "consentement": true,
  "consentementQuotboxAgent": "quotbox-marketplace-v1",
  "telephone": "+46700000000"
}

I JSON-strängen motsvarar \u0040 tecknet @ i e-postadressen.

Hantera svaret och behåll referensen

Läs både HTTP-status och JSON-svaret. En sparad förfrågan kan fortfarande vänta på överföring. Spara värdet i fältet reference så snart du får det.

Svar efter att en förfrågan har sparats
HTTPResultatNästa steg
200Sparad och mottagen av Quotboxenregistree är true och transmis är true. Quotbox har bekräftat mottagningen. Svaret bekräftar inte att ett företag har lämnat en offert.
202Sparad, överföringen väntarenregistree är true, transmis är false och etat är en_attente. Behåll reference och skapa inte en ny förfrågan för samma ärende.
502Sparad, en åtgärd krävsenregistree är true, transmis är false och etat är action_requise. Behåll reference och kontakta oss innan du försöker skapa samma förfrågan igen.

Om anslutningen bryts innan du får ett svar kan resultatet vara okänt. Kontakta oss för kontroll innan du skickar samma ärende på nytt. API:t erbjuder ingen särskild nyckel för att förhindra dubbla förfrågningar.

Fel före eller under mottagningen

400
Begäran kunde inte läsas. Kontrollera att kroppen innehåller giltig JSON.
408
Det tog för lång tid att läsa begärans kropp. Gränsen är 10 sekunder.
413
Begärans kropp är större än 32 KiB.
415
Kontrollera Content-Type. Skicka application/json i UTF-8.
422
Uppgifterna uppfyller inte villkoren. Läs message och, om den finns, listan champs med fältnamn. Rätta uppgifterna innan du försöker igen.
429
För många försök. Vänta den tid som anges i svarshuvudet Retry-After innan du försöker igen.
503
Mottagningen är inte tillgänglig. Kontrollera svarets uppgifter om enregistree och transmis när de finns. Ett fel vid lagring ger enregistree: false.

Personuppgifter och kontakt

Läs hur personuppgifter behandlas innan integrationen används. Kontakta oss om du behöver hjälp med en sparad förfrågan och ange dess referens.