Cuenta

La API de Accounts te permite listar, crear, recuperar, actualizar, eliminar y desarchivar cuentas.

API de Accounts y suscripciones

Dado que la funcionalidad varía entre las suscripciones eDocSync y eDocExchange, es importante entender cómo añadir cuentas puede afectar a los costes y límites de tu suscripción.

eDocSync

Con eDocSync, puedes crear y gestionar cuentas para tus usuarios directamente a través de la API.

Aspectos a tener en cuenta antes de añadir cuentas:

• Coste: Añadir cuentas puede generar cargos adicionales, dependiendo de tu suscripción actual y el número total de cuentas.
• Límite de transacciones: El grupo de cuentas comparte un límite de transacciones. Con eDocSync, el límite del grupo es la cantidad de transacciones incluida por cuenta en tu suscripción multiplicada por el número de cuentas del grupo: con n cuentas y q transacciones incluidas por cuenta, el límite del grupo es n × q. Por eso el límite sube solo cada vez que creas una cuenta, y una cuenta archivada sigue contando hasta que termina el período de facturación en curso. Si el grupo supera el límite, se aplicarán cargos adicionales por transacción.
• Modificaciones: El límite de transacciones de la suscripción no se puede cambiar a través de la API. Para solicitar un cambio, envía un ticket de soporte.

eDocExchange

Con eDocExchange, no puedes crear, eliminar/archivar ni desarchivar cuentas a través de la API. En su lugar, esto debe hacerse a través de la aplicación web:

1. Ve a la pestaña Developers.
2. Haz clic en el icono Edit group junto al nombre de tu grupo.
3. Desde allí puedes añadir o eliminar cuentas.

Notas: Para añadir o eliminar cuentas, debes tener permisos de Admin u Owner de la cuenta con la suscripción y de la cuenta que deseas añadir. Antes de añadir una cuenta al grupo, asegúrate de que ha sido creada con el plan Basic.

Aspectos a tener en cuenta antes de añadir cuentas:

• Coste: Añadir una cuenta genera un coste adicional único.
• Límite de transacciones: El grupo de cuentas comparte un límite de transacciones. Con eDocExchange, el límite del grupo es el de la suscripción contratada: un solo total para todo el grupo, que no se multiplica por el número de cuentas. Añadir cuentas no lo hace subir. Si el grupo supera el límite, se aplicarán cargos adicionales por transacción.
• Modificaciones: El límite de transacciones no se puede cambiar a través de la API. Si la aplicación web no ofrece la opción de actualizar tu nivel en la sección de suscripción, envía un ticket de soporte para solicitar un cambio.

El límite y el consumo en la API

Cada cuenta que devuelven GET /accounts y GET /accounts/{id} lleva tres campos sobre transacciones. Léelos así:

• transactions_limit es el límite del grupo, no el de esa cuenta. Por eso todas las cuentas del grupo muestran el mismo valor.
• transactions_count y transactions_count_previous_period son el consumo de esa cuenta, en el período de facturación actual y en el anterior.

El límite se aplica al consumo de todo el grupo. Encontrarás qué cuenta como transacción facturable y un ejemplo de respuesta en Transacción.

Ejemplo de solicitud:

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"
    }
  }'