Customer

Customer management, archival, and per-customer statistics

Display a listing of customers

GET /api/v1/customers

Nécessite une authentification (jeton Bearer) et l’en-tête X-Organization-Id.

Paramètres

Réponses

Exemple de requête

curl -X GET "https://kworia.com/api/v1/customers" \
  -H "Authorization: Bearer {{access_token}}" \
  -H "X-Organization-Id: {{organization_id}}" \
  -H "Accept: application/json"

Store a newly created customer

POST /api/v1/customers

Nécessite une authentification (jeton Bearer) et l’en-tête X-Organization-Id.

Corps de la requête

Réponses

Exemple de requête

curl -X POST "https://kworia.com/api/v1/customers" \
  -H "Authorization: Bearer {{access_token}}" \
  -H "X-Organization-Id: {{organization_id}}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "email": "string",
    "phone": "string",
    "website": "string",
    "tax_number": "string",
    "address_line1": "string",
    "address_line2": "string",
    "city": "string",
    "state": "string",
    "postal_code": "string",
    "country": "string",
    "billing_subdivision_code": "string",
    "shipping_subdivision_code": "string",
    "notes": "string",
    "language": "string",
    "currency": "string",
    "einvoicing_identifier_scheme": "string",
    "einvoicing_identifier_value": "string"
}'

Display the specified customer

GET /api/v1/customers/{id}

Nécessite une authentification (jeton Bearer) et l’en-tête X-Organization-Id.

Paramètres

Réponses

Exemple de requête

curl -X GET "https://kworia.com/api/v1/customers/{id}" \
  -H "Authorization: Bearer {{access_token}}" \
  -H "X-Organization-Id: {{organization_id}}" \
  -H "Accept: application/json"

Update the specified customer

PUT /api/v1/customers/{id}

Nécessite une authentification (jeton Bearer) et l’en-tête X-Organization-Id.

Paramètres

Corps de la requête

Réponses

Exemple de requête

curl -X PUT "https://kworia.com/api/v1/customers/{id}" \
  -H "Authorization: Bearer {{access_token}}" \
  -H "X-Organization-Id: {{organization_id}}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "email": "string",
    "phone": "string",
    "website": "string",
    "tax_number": "string",
    "address_line1": "string",
    "address_line2": "string",
    "city": "string",
    "state": "string",
    "postal_code": "string",
    "country": "string",
    "billing_subdivision_code": "string",
    "shipping_subdivision_code": "string",
    "notes": "string",
    "language": "string",
    "currency": "string",
    "einvoicing_identifier_scheme": "string",
    "einvoicing_identifier_value": "string"
}'

Remove the specified customer

DELETE /api/v1/customers/{id}

Nécessite une authentification (jeton Bearer) et l’en-tête X-Organization-Id.

Paramètres

Réponses

Exemple de requête

curl -X DELETE "https://kworia.com/api/v1/customers/{id}" \
  -H "Authorization: Bearer {{access_token}}" \
  -H "X-Organization-Id: {{organization_id}}" \
  -H "Accept: application/json"

Get customer's invoices

GET /api/v1/customers/{id}/invoices

Nécessite une authentification (jeton Bearer) et l’en-tête X-Organization-Id.

Paramètres

Réponses

Exemple de requête

curl -X GET "https://kworia.com/api/v1/customers/{id}/invoices" \
  -H "Authorization: Bearer {{access_token}}" \
  -H "X-Organization-Id: {{organization_id}}" \
  -H "Accept: application/json"

Get customer's quotes

GET /api/v1/customers/{id}/quotes

Nécessite une authentification (jeton Bearer) et l’en-tête X-Organization-Id.

Paramètres

Réponses

Exemple de requête

curl -X GET "https://kworia.com/api/v1/customers/{id}/quotes" \
  -H "Authorization: Bearer {{access_token}}" \
  -H "X-Organization-Id: {{organization_id}}" \
  -H "Accept: application/json"

Customer statement of account

GET /api/v1/customers/{id}/statement

Nécessite une authentification (jeton Bearer) et l’en-tête X-Organization-Id.

Opening balance, invoice/payment/credit-note entries and closing balance for the period (start_date/end_date required), in the organization currency. (#847)

Paramètres

Réponses

Exemple de requête

curl -X GET "https://kworia.com/api/v1/customers/{id}/statement" \
  -H "Authorization: Bearer {{access_token}}" \
  -H "X-Organization-Id: {{organization_id}}" \
  -H "Accept: application/json"

Get customer statistics

GET /api/v1/customers/{id}/statistics

Nécessite une authentification (jeton Bearer) et l’en-tête X-Organization-Id.

Paramètres

Réponses

Exemple de requête

curl -X GET "https://kworia.com/api/v1/customers/{id}/statistics" \
  -H "Authorization: Bearer {{access_token}}" \
  -H "X-Organization-Id: {{organization_id}}" \
  -H "Accept: application/json"

Validate the customer's e-invoicing identifier on the network

GET /api/v1/customers/{id}/validate-network

Nécessite une authentification (jeton Bearer) et l’en-tête X-Organization-Id.

Looks up the customer's stored einvoicing_identifier_scheme/einvoicing_identifier_value on the e-invoicing network of the provider resolved for the customer's country, and persists a successful verification (einvoicing_identifier_verified). Returns 422 when the customer has no identifier stored, when no country can be resolved (the customer country, billing country, or a country-specific identifier scheme all absent), or when the resolved provider (e.g. FNE clearance countries) does not support participant lookup. When the customer has no stored country it is inferred from a country-specific identifier scheme (e.g. 0208 → BE). A verified: false result never clears an earlier successful verification, because provider transport errors are indistinguishable from a genuine not-found. (#928) (#954)

Paramètres

Réponses

Exemple de requête

curl -X GET "https://kworia.com/api/v1/customers/{id}/validate-network" \
  -H "Authorization: Bearer {{access_token}}" \
  -H "X-Organization-Id: {{organization_id}}" \
  -H "Accept: application/json"