Compte

L’API de comptes et permet llistar, crear, recuperar, actualitzar, eliminar i desarxivar comptes.

API de comptes i subscripcions

Com que la funcionalitat varia entre les subscripcions eDocSync i eDocExchange, és important entendre com l’addició de comptes pot afectar els costos i límits de la teva subscripció.

eDocSync

Amb eDocSync, pots crear i gestionar comptes per als teus usuaris directament via API.

Aspectes a tenir en compte abans d’afegir comptes:

• Cost: Afegir comptes pot comportar càrrecs addicionals, en funció de la teva subscripció actual i del nombre total de comptes.
• Límit de transaccions: El grup de comptes té un límit de transaccions compartit. Amb eDocSync, el límit del grup és la quantitat de transaccions inclosa per compte a la teva subscripció multiplicada pel nombre de comptes del grup: amb n comptes i q transaccions incloses per compte, el límit del grup és n × q. Per això el límit puja sol cada vegada que crees un compte, i un compte arxivat continua comptant fins que acaba el període de facturació en curs. Si el grup supera el límit, s’aplicaran càrrecs addicionals per transacció.
• Modificacions: El límit de transaccions de la subscripció no es pot canviar a través de l’API. Per sol·licitar un canvi, envia un tiquet de suport per demanar un canvi a la teva subscripció.

eDocExchange

Amb eDocExchange, no pots crear, eliminar/arxivar ni desarxivar comptes a través de l’API. En canvi, això s’ha de fer a través de l’aplicació web:

1. Ves a la pestanya Developers.
2. Fes clic a la icona Editar grup al costat del nom del teu grup.
3. Des d’allà, pots afegir o eliminar comptes.

Notes: Per afegir o eliminar comptes, has de tenir permisos d’Administrador o Propietari del compte amb la subscripció i del compte que vols afegir. Abans d’afegir un compte al grup, assegura’t que s’ha creat amb el pla Bàsic.

Aspectes a tenir en compte abans d’afegir comptes:

• Cost: Afegir un compte comporta un cost addicional únic.
• Límit de transaccions: El grup de comptes té un límit de transaccions compartit. Amb eDocExchange, el límit del grup és el de la subscripció contractada: un sol total per a tot el grup, que no es multiplica pel nombre de comptes. Afegir comptes no el fa pujar. Si el grup supera el límit, s’aplicaran càrrecs addicionals per transacció.
• Modificacions: El límit de transaccions no es pot canviar a través de l’API. Si l’aplicació web no ofereix l’opció d’actualitzar el teu nivell a la secció de subscripció, envia un tiquet de suport per sol·licitar un canvi a la teva subscripció.

El límit i el consum a l’API

Cada compte que retornen GET /accounts i GET /accounts/{id} porta tres camps sobre transaccions. Llegeix-los així:

• transactions_limit és el límit del grup, no el d’aquell compte. Per això tots els comptes del grup mostren el mateix valor.
• transactions_count i transactions_count_previous_period són el consum d’aquell compte, en el període de facturació actual i en l’anterior.

El límit s’aplica al consum de tot el grup. Trobaràs què compta com a transacció facturable i un exemple de resposta a Transacció.

Exemple de petició:

curl --request POST \
  --url https://api-staging.b2brouter.net/accounts \
  --header 'X-B2B-API-KEY: {API_KEY}' \
  --header 'X-B2B-API-Version: {API_VERSION}' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "account": {
      "country": "de",
      "rounding_method": "half_up",
      "tin_scheme": 9930,
      "tin_value": "DE123456789",
      "name": "Muster GmbH",
      "address": "Musterstraße 45",
      "city": "Berlin",
      "postalcode": "10115",
      "province": "Berlin",
      "email": "jane.doe@example.com"
    }
  }'