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

# Crear Tercero

`POST /tercero`

## Request

- Base URL: `https://api.loggro.com/apik/loggro-enterprise`
- URL: `https://api.loggro.com/apik/loggro-enterprise/tercero`
- Auth: HTTP bearer

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. Este campo es siempre obligatorio: - Cuando `naturaleza` es J (Jurídica), se debe enviar el nombre o razón social de la empresa. - Cuando `naturaleza` es N (Natural), se debe enviar el primer apellido de la persona.
    - `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. Este campo es siempre obligatorio: - Cuando `naturaleza` es J (Jurídica), se debe enviar el nombre o razón social de la empresa. - Cuando `naturaleza` es N (Natural), se debe enviar el primer apellido de la persona.
    - `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.dev/loggro/apis/enterprise-api-s.md) - [All operations](https://skmtc.dev/loggro/apis/enterprise-api-s/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/enterprise-api-s/revisions/933dac40ea9c?raw)