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.
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.
| Fält | Uppgift | Värde eller villkor |
|---|---|---|
| famille | Projekt | achat = sjöcontainer, stockage = förvaring, frigorifique = kylcontainer, amenage = inredd container, baseVie = personalutrymmen eller byggbod. |
| mode | Köp eller hyra | achat = köp, location = hyra. |
| format | Storlek | 20DRY, 40DRY, 40HC eller 20HC. Använd aDefinir om storleken är okänd, eller autre för ett annat format. |
| quantite | Antal | Ett heltal mellan 1 och 50. |
| codePostal | Postnummer i Sverige | Fem siffror, med eller utan mellanslag. Exempelvis 11120 eller 111 20. Första siffran ska vara 1–9. |
| prenom | Förnamn | 1–80 tecken. Fältet får inte bestå enbart av blanksteg. |
| nom | Efternamn | 1–80 tecken. Fältet får inte bestå enbart av blanksteg. |
| E-postadress | En giltig e-postadress, 6–254 tecken. | |
| telephone | Kundens telefonnummer | Högst 40 tecken. Vid mottagning via Quotbox krävs ett giltigt nummer med minst sex siffror. |
| consentement | Kundens godkännande | Det booleska värdet true efter kundens uttryckliga godkännande. |
| consentementQuotboxAgent | Samtyckesversion | Den exakta versionen i JSON-kontraktet, för närvarande quotbox-marketplace-v1. |
Villkor som beror på projektet
- Vid hyra,
mode: location, krävsdureeMois, ett heltal mellan 1 och 120 månader. - För personalutrymmen,
famille: baseVie, utanusageBungalowkrävs bådedureeMoisoch objektetchantier, även om du väljer köp. AngeeffectifHommesocheffectifFemmessom heltal mellan 0 och 2 000. Summan ska vara minst en person. Objektet kan också innehållamobileochtravauxSalissantssom booleska värden. - För en byggbod anger du
usageBungalowmedfamille: baseVie. Skicka då intechantier. Ometatanges får värdet varaneuf,occasionellerpeuImporte. lieuStockagehör tillstockage. Vid köp får platsen bara varasurSite. Vid hyra kan den också varadepot.projetAmenageochusageAmenagehör tillamenage.regimeFroidochtemperatureCiblehör tillfrigorifique. Ange temperaturen som en sträng med ett värde mellan −80 och +40 °C och högst två decimaler.
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.
| HTTP | Resultat | Nästa steg |
|---|---|---|
| 200 | Sparad och mottagen av Quotbox | enregistree är true och transmis är true. Quotbox har bekräftat mottagningen. Svaret bekräftar inte att ett företag har lämnat en offert. |
| 202 | Sparad, överföringen väntar | enregistree ä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. |
| 502 | Sparad, en åtgärd krävs | enregistree ä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.