createAccount
POST /api/account/createAccount/{countryId}
Crea la cuenta de una empresa. Es asíncrono: devuelve un trackId para consultar el estado final con getProcess.
Microprocesos internos
| # | Acción |
|---|---|
| 1 | Creación de la cuenta de la empresa |
| 2 | Creación del usuario administrador |
| 3 | Carga del certificado digital (si aplica) |
| 4 | Generación de ApiKeys (OAuth 2.0 o Basic Auth) |
Parámetros de ruta
| Campo | Tipo | Req. | Descripción |
|---|---|---|---|
countryId | string | Requerido | Código ISO del país (ej: ar, cl, mx) |
Body — estructura completa
| Campo | Tipo | Req. | Descripción |
|---|---|---|---|
accountUser.account.code | string | Requerido | TaxId / RUT de la empresa |
accountUser.account.name | string | Requerido | Razón social |
accountUser.account.description | string | Opcional | Descripción libre |
accountUser.account.address | string | Opcional | Dirección |
accountUser.account.city | string | Opcional | Ciudad |
accountUser.account.province | string | Opcional | Provincia / Estado |
accountUser.account.phone | string | Opcional | Teléfono |
accountUser.user.name | string | Requerido | Nombre del usuario admin |
accountUser.user.email | string | Requerido | Email del usuario admin |
accountUser.authenticationMethod | integer | Requerido | 1 = OAuth 2.0 · 0 = Basic Auth |
certificateRootDto.certBase64 | string | Condicional | Certificado .pfx en Base64 |
certificateRootDto.certKeyBase64 | string | Condicional | Clave privada en Base64 (cuando aplica) |
certificateRootDto.password | string | Condicional | Contraseña del certificado |
certificateRootDto.defaultCertificate | boolean | Condicional | Define si es el certificado predeterminado |
taxEntity | object | Condicional | Datos de entidad tributaria — ver Onboarding por País |
createAccount
{
"accountUser": {
"account": {
"code": "{{taxId}}",
"name": "Nombre Organización",
"description": "",
"address": "",
"city": "",
"province": "",
"phone": "",
"fax": ""
},
"user": {
"name": "Nombre Usuario Admin",
"email": "user@empresa.com"
},
"authenticationMethod": 1
},
"certificateRootDto": {
"certBase64": "BASE64_CERTIFICADO",
"certKeyBase64": "",
"password": "PASSWORD_CERT",
"defaultCertificate": false
}
}