Hoppa till innehållet

API and integrations Headless commerce Addresses

Svenska

Addresses

The signed-in customer's delivery addresses, including which one is the default.

5 calls GET POST PATCH DELETE Base URL https://api.erp.fluit.cloud/ecom

Authentication, error codes, rate limits, idempotency and pagination apply to every call and are documented once under Getting started.

GET /portal/addresses

List addresses

Returns delivery addresses for the authenticated customer.

Responses

200 PortalAddressListResponse
Field Type
items PortalAddressItem[] · nullable
429 Rate limit exceeded. Wait the number of seconds given in Retry-After. The body is problem-shaped application/json, not application/problem+json. This API sends no X-RateLimit-* headers — the quota is discovered here.
  • Retry-After — Seconds to wait before retrying.

Standard errors: 401 403 Errors

Examples

curl 
curl "https://api.erp.fluit.cloud/ecom/portal/addresses" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Tenant-Id: $FLUIT_TENANT_ID" \
  -H "X-Channel: web"
Response 200 
{
  "items": [
    {
      "city": "Stockholm",
      "contactPerson": "string",
      "country": "string",
      "email": "order@acme.se",
      "id": "0f8b2c1e-4d3a-4b7e-9f10-2a6c5d8e1b44",
      "isDefault": true,
      "name": "Widget A",
      "notes": "string",
      "phone": "+46 8 123 45 67",
      "postalCode": "11122",
      "street1": "Storgatan 1",
      "street2": "string"
    }
  ]
}

Base URL https://api.erp.fluit.cloud/ecom. The response example is generated from the schema: the shape is right, the values are made up.

POST /portal/addresses

Create address

Creates a new delivery address for the authenticated customer.

Body required

Field Type
city string · nullable
contactPerson string · nullable
country string · nullable
email string · nullable
isDefault boolean
name string · nullable
notes string · nullable
phone string · nullable
postalCode string · nullable
street1 string · nullable
street2 string · nullable

Responses

200 Empty body.
429 Rate limit exceeded. Wait the number of seconds given in Retry-After. The body is problem-shaped application/json, not application/problem+json. This API sends no X-RateLimit-* headers — the quota is discovered here.
  • Retry-After — Seconds to wait before retrying.

Standard errors: 400 401 403 Errors

Examples

curl 
curl -X POST "https://api.erp.fluit.cloud/ecom/portal/addresses" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Tenant-Id: $FLUIT_TENANT_ID" \
  -H "X-Channel: web" \
  -H "Content-Type: application/json" \
  -d @body.json

Base URL https://api.erp.fluit.cloud/ecom.

PATCH /portal/addresses/{id}

Update address

Updates an existing delivery address for the authenticated customer.

Path parameters

Field Type
id Required string(uuid)

Body required

Field Type
city string · nullable
contactPerson string · nullable
country string · nullable
email string · nullable
name string · nullable
notes string · nullable
phone string · nullable
postalCode string · nullable
street1 string · nullable
street2 string · nullable

Responses

204 Empty body.
429 Rate limit exceeded. Wait the number of seconds given in Retry-After. The body is problem-shaped application/json, not application/problem+json. This API sends no X-RateLimit-* headers — the quota is discovered here.
  • Retry-After — Seconds to wait before retrying.

Standard errors: 400 401 404 Errors

Examples

curl 
curl -X PATCH "https://api.erp.fluit.cloud/ecom/portal/addresses/{id}" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Tenant-Id: $FLUIT_TENANT_ID" \
  -H "X-Channel: web" \
  -H "Content-Type: application/json" \
  -d @body.json

Base URL https://api.erp.fluit.cloud/ecom.

DELETE /portal/addresses/{id}

Delete address

Deletes a delivery address for the authenticated customer.

Path parameters

Field Type
id Required string(uuid)

Responses

204 Empty body.
429 Rate limit exceeded. Wait the number of seconds given in Retry-After. The body is problem-shaped application/json, not application/problem+json. This API sends no X-RateLimit-* headers — the quota is discovered here.
  • Retry-After — Seconds to wait before retrying.

Standard errors: 401 404 Errors

Examples

curl 
curl -X DELETE "https://api.erp.fluit.cloud/ecom/portal/addresses/{id}" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Tenant-Id: $FLUIT_TENANT_ID" \
  -H "X-Channel: web"

Base URL https://api.erp.fluit.cloud/ecom.

POST /portal/addresses/{id}/set-default

Set default address

Sets a delivery address as the default for the authenticated customer.

Path parameters

Field Type
id Required string(uuid)

Responses

204 Empty body.
429 Rate limit exceeded. Wait the number of seconds given in Retry-After. The body is problem-shaped application/json, not application/problem+json. This API sends no X-RateLimit-* headers — the quota is discovered here.
  • Retry-After — Seconds to wait before retrying.

Standard errors: 401 404 Errors

Examples

curl 
curl -X POST "https://api.erp.fluit.cloud/ecom/portal/addresses/{id}/set-default" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Tenant-Id: $FLUIT_TENANT_ID" \
  -H "X-Channel: web"

Base URL https://api.erp.fluit.cloud/ecom.

Schemas

The objects this group's calls refer to. The field tables above go one level deep and link here rather than repeating the same schema on every endpoint.

PortalAddressItem

PortalAddressItem
Field Type
city string · nullable
contactPerson string · nullable
country string · nullable
email string · nullable
id string(uuid)
isDefault boolean
name string · nullable
notes string · nullable
phone string · nullable
postalCode string · nullable
street1 string · nullable
street2 string · nullable