Crea o reemplaza el perfil del emisor

PUT/api/v1/issuer

NIT, DV y razón social salen de la cuenta. El PIN del software se cifra y nunca se devuelve; si se omite al actualizar se conserva.

Cuerpo de la petición application/json

person_typeinteger
1 jurídica, 2 natural
Valores: 1 · 2
document_typestring· por defecto 31
31 NIT para persona jurídica; 13 cédula para persona natural (la DIAN valida el nombre del RUT contra la cédula)
trade_namestring
addressobjectobligatorio
+ Ver 8 campos− Ocultar 8 campos
- linestring
  Ejemplo: Cra 7 # 71-21
- city_codestring
  DIVIPOLA del municipio (5 dígitos)
  Ejemplo: 11001
- city_namestring
  Ejemplo: Bogotá, D.C.
- department_codestring
  DIVIPOLA del departamento (2 dígitos)
  Ejemplo: 11
- department_namestring
  Ejemplo: Bogotá
- postal_zonestring
- country_codestring
  ISO 3166-1; vacío = CO
- country_namestring
tax_level_codesarray<string>
Valores: O-13 · O-15 · O-23 · O-47 · R-99-PN
tax_schemestring
Valores: 01 · 04 · ZA · ZZ
commercial_registrationstring
emailstring · emailobligatorio
phonestring
software_modestring· por defecto provider
Valores: provider · own
software_idstring
Obligatorio con software propio
software_pinstring
Obligatorio con software propio la primera vez
test_set_idstring
Set de pruebas de facturación (habilitación)
support_test_set_idstring
Set de pruebas del documento soporte
payroll_test_set_idstring
Set de pruebas de nómina electrónica
payroll_software_idstring
Solo software propio: la DIAN habilita la nómina como otro software. Vacío = la nómina usa software_id
payroll_software_pinstring
PIN del software de nómina; obligatorio la primera vez que se envía payroll_software_id
pos_test_set_idstring
Set de pruebas del documento equivalente POS
pos_software_idstring
Solo software propio: la DIAN habilita el documento equivalente como otro software. Vacío = el POS usa software_id
pos_software_pinstring
PIN del software del documento equivalente; obligatorio la primera vez que se envía pos_software_id

Respuestas

200OK

person_typeinteger
document_typestring
trade_namestring
addressobject
+ Ver 8 campos− Ocultar 8 campos
- linestring
  Ejemplo: Cra 7 # 71-21
- city_codestring
  DIVIPOLA del municipio (5 dígitos)
  Ejemplo: 11001
- city_namestring
  Ejemplo: Bogotá, D.C.
- department_codestring
  DIVIPOLA del departamento (2 dígitos)
  Ejemplo: 11
- department_namestring
  Ejemplo: Bogotá
- postal_zonestring
- country_codestring
  ISO 3166-1; vacío = CO
- country_namestring
tax_level_codesarray<string>
tax_schemestring
commercial_registrationstring
emailstring
phonestring
software_modestring
software_idstring
has_software_pinboolean
test_set_idstring
support_test_set_idstring
payroll_test_set_idstring
payroll_software_idstring
has_payroll_software_pinboolean
pos_test_set_idstring
pos_software_idstring
has_pos_software_pinboolean
has_logoboolean
La cuenta subió un logo (PUT /issuer/logo)
updated_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