Crea una cuenta hija (cliente de la casa de software)

POST/api/v1/account/children

Una sola cuenta activa por NIT. La casa actúa sobre la nueva cuenta con su key y Facturoa-Account.

Cuerpo de la petición application/json

document_typestring· por defecto 31
13 cédula (persona natural) o 31 NIT
Valores: 13 · 31
nitstringobligatorio
Número sin DV; único entre cuentas activas sin importar el tipo
Ejemplo: 900123456
dvstringobligatorio
Ejemplo: 8
namestringobligatorio
Ejemplo: Emisor SAS
emailstring · email
Ejemplo: facturacion@emisor.co
kindstring· por defecto independent
Solo al crear por /platform. Las cuentas hijas son siempre independent
Valores: independent · software_house
environmentstring· por defecto habilitacion
Ambiente inicial (el registro autoservicio empieza en staging)
Valores: staging · habilitacion · production

Respuestas

201Creada

idstring · uuid
parent_account_idstring · uuid
Casa de software dueña; igual a id si no tiene padre
kindstring
Valores: independent · software_house
emailstring
document_typestring
13 cédula o 31 NIT
Valores: 13 · 31
nitstring
dvstring
namestring
environmentstring
Valores: staging · habilitacion · production
created_atstring · date-time

400Datos inválidos (details trae los campos)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

401Falta la key o es inválida, está deshabilitada, vencida o revocada (error.missing_api_key, error.invalid_api_key, error.api_key.disabled, error.api_key.expired, error.api_key.revoked)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

403La cuenta no puede hacer esto (p. ej. no es casa de software: error.account.not_software_house, o la cuenta de Facturoa-Account no es hija: error.account.not_child)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

409Conflicto con el estado actual (p. ej. documento referenciado no aceptado, rango agotado)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring