Pide vincular una cuenta independiente existente (casa de software)

POST/api/v1/account/children/link

Envía al correo del emisor (el de la cuenta o el del perfil del emisor) un código que vence en 24 horas. El emisor se lo da a la casa, que confirma en /account/children/link/confirm. Solo para cuentas independientes activas, sin clientes.

Cuerpo de la petición application/json

nitstringobligatorio
Ejemplo: 900123456

Respuestas

202Código enviado al emisor

link_idstring · uuid
account_idstring · uuid
email_hintstring
Ejemplo: f*******@emisor.co
expires_atstring · date-time

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