---
title: "Crear Tercero"
method: POST
path: "/tercero"
tags: ["Contabilidad"]
---

# Crear Tercero

`POST /tercero`

Permite registrar uno o varios terceros. Cada petición puede contener múltiples terceros, y cada registro será validado individualmente. El servicio retorna el resultado de la importación con el detalle de las operaciones exitosas y las fallidas.

## Request body

- union
  - object
    - `control` string, required — Cadena que identifica un lote de terceros a importar.
    - `operacion` 'M' | 'C', required — Operación a realizar sobre el tercero. Valores permitidos: M = Modificar, C = Crear
    - `tipoIdentificacion` 'U' | 'T' | 'C' | 'X' | 'E' | 'N' | 'O' | 'Y' | 'A' | 'K' | 'V' | 'B' — Tipo de documento asociado al tercero. Definido por la DIAN. Valores permitidos: U: Registro civil (11), T: Tarjeta identidad (12), C: Cédula Ciudadanía (13), X: Tarjeta Extranjería (21), E: Cédula de Extranjería (22), N: NIT (31), O: Pasaporte (41), Y: Extranjero (42), A: Nit Otro País (50), K: Niup (91), V: PEP (47), B: PPT (48).
    - `identificacion` string, required — Número de identificación del tercero.
    - `nit` string — Número de NIT del tercero.
    - `naturaleza` 'J' | 'N' — Naturaleza del tercero. Valores permitidos: J = Jurídica, N = Natural
    - `primerApellido` string — Razón social o primer apellido del tercero.
    - `segundoApellido` string — Segundo apellido del tercero.
    - `nombreCompleto` string — Nombre completo del tercero.
    - `sigla` string — Sigla de la organización (si aplica).
    - `actividadEconomica` string — **Código de la actividad económica.** Este valor puede ser consultado en el endpoint → [/consultarActividadEconomica](https://developer.loggro.com/reference/consultarActividadEconomica#/)
    - `estado` 'AC' | 'SU' — Estado del tercero. Valores permitidos: AC = Activo, SU = Suspendido
    - `direccion` string — Dirección principal del tercero.
    - `direccion2` string — Dirección secundaria del tercero.
    - `codigoCiudad` string — **Código de la ciudad.** Este valor puede ser consultado en el endpoint → [/consultarCiudad](https://developer.loggro.com/reference/consultarciudad#/)
    - `telefono` string — Teléfono principal.
    - `telefono2` string — Teléfono secundario.
    - `telefono3` string — Teléfono adicional.
    - `fax` string — Número de fax.
    - `zonaPostal` string — Zona postal.
    - `correo` string — Correo electrónico principal.
    - `correoCompra` string — Correo electrónico de compras.
    - `apartadoAereo` string — Número de apartado aéreo.
    - `terceroTransportador` 'S' | 'N' — ¿Es transportador?
    - `agenteRetenedor` 'S' | 'N' — ¿Es agente retenedor?
    - `granContribuyente` 'S' | 'N' — ¿Es gran contribuyente?
    - `autoretenedor` 'S' | 'N' — ¿Es autoretenedor?
    - `exentoRetencion` 'S' | 'N' — ¿Está exento de retención?
    - `responsableIVA` 'C' | 'S' — Responsable de IVA. Valores permitidos: C = Contribuyente, S = Simplificado
    - `responsableActivos` 'S' | 'N' — ¿Responsable de activos?
    - `comentario` string — Comentario adicional.
    - `declaraRenta` 'S' | 'N' — ¿Declarante de renta?
    - `sujPasivoImptoNacionalConsumo` 'S' | 'N' — ¿Sujeto pasivo de impuesto nacional al consumo?
    - `regimenSimpleTributacion` 'S' | 'N' — ¿Acogido al régimen simple de tributación?
    - `comidasUltraprocesadas` 'S' | 'N' — ¿Grava comidas ultraprocesadas?
    - `bebidasAzucaradas` 'S' | 'N' — ¿Grava bebidas azucaradas?
    - `proveedorCI` 'S' | 'N' — ¿Es proveedor C.I.?
  - RecepcionTerceroGralDatosEntrada[]
    - `control` string, required — Cadena que identifica un lote de terceros a importar.
    - `operacion` 'M' | 'C', required — Operación a realizar sobre el tercero. Valores permitidos: M = Modificar, C = Crear
    - `tipoIdentificacion` 'U' | 'T' | 'C' | 'X' | 'E' | 'N' | 'O' | 'Y' | 'A' | 'K' | 'V' | 'B' — Tipo de documento asociado al tercero. Definido por la DIAN. Valores permitidos: U: Registro civil (11), T: Tarjeta identidad (12), C: Cédula Ciudadanía (13), X: Tarjeta Extranjería (21), E: Cédula de Extranjería (22), N: NIT (31), O: Pasaporte (41), Y: Extranjero (42), A: Nit Otro País (50), K: Niup (91), V: PEP (47), B: PPT (48).
    - `identificacion` string, required — Número de identificación del tercero.
    - `nit` string — Número de NIT del tercero.
    - `naturaleza` 'J' | 'N' — Naturaleza del tercero. Valores permitidos: J = Jurídica, N = Natural
    - `primerApellido` string — Razón social o primer apellido del tercero.
    - `segundoApellido` string — Segundo apellido del tercero.
    - `nombreCompleto` string — Nombre completo del tercero.
    - `sigla` string — Sigla de la organización (si aplica).
    - `actividadEconomica` string — **Código de la actividad económica.** Este valor puede ser consultado en el endpoint → [/consultarActividadEconomica](https://developer.loggro.com/reference/consultarActividadEconomica#/)
    - `estado` 'AC' | 'SU' — Estado del tercero. Valores permitidos: AC = Activo, SU = Suspendido
    - `direccion` string — Dirección principal del tercero.
    - `direccion2` string — Dirección secundaria del tercero.
    - `codigoCiudad` string — **Código de la ciudad.** Este valor puede ser consultado en el endpoint → [/consultarCiudad](https://developer.loggro.com/reference/consultarciudad#/)
    - `telefono` string — Teléfono principal.
    - `telefono2` string — Teléfono secundario.
    - `telefono3` string — Teléfono adicional.
    - `fax` string — Número de fax.
    - `zonaPostal` string — Zona postal.
    - `correo` string — Correo electrónico principal.
    - `correoCompra` string — Correo electrónico de compras.
    - `apartadoAereo` string — Número de apartado aéreo.
    - `terceroTransportador` 'S' | 'N' — ¿Es transportador?
    - `agenteRetenedor` 'S' | 'N' — ¿Es agente retenedor?
    - `granContribuyente` 'S' | 'N' — ¿Es gran contribuyente?
    - `autoretenedor` 'S' | 'N' — ¿Es autoretenedor?
    - `exentoRetencion` 'S' | 'N' — ¿Está exento de retención?
    - `responsableIVA` 'C' | 'S' — Responsable de IVA. Valores permitidos: C = Contribuyente, S = Simplificado
    - `responsableActivos` 'S' | 'N' — ¿Responsable de activos?
    - `comentario` string — Comentario adicional.
    - `declaraRenta` 'S' | 'N' — ¿Declarante de renta?
    - `sujPasivoImptoNacionalConsumo` 'S' | 'N' — ¿Sujeto pasivo de impuesto nacional al consumo?
    - `regimenSimpleTributacion` 'S' | 'N' — ¿Acogido al régimen simple de tributación?
    - `comidasUltraprocesadas` 'S' | 'N' — ¿Grava comidas ultraprocesadas?
    - `bebidasAzucaradas` 'S' | 'N' — ¿Grava bebidas azucaradas?
    - `proveedorCI` 'S' | 'N' — ¿Es proveedor C.I.?

## Response `201`

Todos los terceros fueron creados correctamente

- RespuestaImportacion[]
  - `identificacion` string
  - `operacionExitosa` boolean
  - `mensaje` string

## Other responses

- `400` — Error en la validación o al menos un tercero falló en la creación
- `404` — Recurso no encontrado
- `500` — Error interno inesperado en el servidor

---

[API](https://skmtc.net/loggro/apis/documentos-electr-nicos.md) · [All operations](https://skmtc.net/loggro/apis/documentos-electr-nicos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loggro/documentos-electr-nicos/versions/f390b90daf37/schema)