Registrar un emisor

POST

/emitters

curl --request POST \
  --url https://api.sudte.com/v1/emitters \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --data '{ "nit": "example", "nrc": "example", "name": "example", "trade_name": "example", "economic_activity": "example", "establishment_type": "example", "address": { "department": "example", "municipality": "example", "district": "example", "line": "example" }, "phone": "example", "email": "hello@example.com", "numbering": "centralized", "logo_url": "https://example.com", "is_large_taxpayer": false }'

Autorización

• apiKey
• session

Parámetros

Cabeceras

Idempotency-Key

obligatorio

string

<= 255 characters

Cuerpo de la solicitud^obligatorio

Media type application/json

object

nit

obligatorio

string

nrc

obligatorio

string

name

obligatorio

string

trade_name

string

economic_activity

obligatorio

CAT-019

string

establishment_type

CAT-009

string

address

obligatorio

object

department

CAT-012

string

municipality

CAT-013

string

district

CAT-008

string

line

string

phone

string

email

obligatorio

string format: email

numbering

Normativa §7.1.2

string

default: per_establishment

Allowed values: centralized per_establishment

logo_url

string format: uri

is_large_taxpayer

Gran contribuyente (agente de retención/percepción). Habilita perception en CCF

boolean

Respuestas

201

Emisor creado

Media type application/json

object

nit

obligatorio

string

nrc

obligatorio

string

name

obligatorio

string

trade_name

string

economic_activity

obligatorio

CAT-019

string

establishment_type

CAT-009

string

address

obligatorio

object

department

CAT-012

string

municipality

CAT-013

string

district

CAT-008

string

line

string

phone

string

email

obligatorio

string format: email

numbering

Normativa §7.1.2

string

default: per_establishment

Allowed values: centralized per_establishment

logo_url

string format: uri

is_large_taxpayer

Gran contribuyente (agente de retención/percepción). Habilita perception en CCF

boolean

id

string

credentials

Array<object>

object

environment

00 pruebas, 01 producción (CAT-001)

string

Allowed values: 00 01

certificate_loaded

boolean

certificate_nit

string

mh_login_ok

boolean

checked_at

string format: date-time

mh_user

NIT del usuario de la API del MH (no es secreto)

string

certificate_valid_until

string format: date-time

message

Resultado legible de la última validación o prueba de conexión

string

created_at

string format: date-time

Example

{
  "numbering": "centralized",
  "is_large_taxpayer": false,
  "credentials": [
    {
      "environment": "00"
    }
  ]
}

default

Error (RFC 9457)

Media type application/problem+json

object

type

string format: uri

title

string

status

integer

detail

string

instance

string

request_id

string

errors

Array<object>

object

path

string

message

string

mh

object

codigoMsg

string

descripcionMsg

string

observaciones

Array<string>

Example ^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "request_id": "example",
  "errors": [
    {
      "path": "example",
      "message": "example"
    }
  ],
  "mh": {
    "codigoMsg": "example",
    "descripcionMsg": "example",
    "observaciones": [
      "example"
    ]
  }
}