Crear Tercero

post

https://api.loggro.com/apik/loggro-enterprise/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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Arreglo de terceros generales a crear o modificar.

control

string

required

length between 1 and 15

Cadena que identifica un lote de terceros a importar.

operacion

string

enum

required

Operación a realizar sobre el tercero.

Valores permitidos: M = Modificar, C = Crear

Allowed:

tipoIdentificacion

string

enum

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

length between 1 and 30

Número de identificación del tercero.

nit

string

length between 1 and 30

Número de NIT del tercero.

naturaleza

string

enum

Naturaleza del tercero.

Valores permitidos: J = Jurídica, N = Natural

Allowed:

primerApellido

string

length between 1 and 75

Razón social o primer apellido del tercero.

segundoApellido

string

length between 1 and 24

Segundo apellido del tercero.

nombreCompleto

string

length between 1 and 25

Nombre completo del tercero.

sigla

string

length between 1 and 45

Sigla de la organización (si aplica).

actividadEconomica

string

length between 1 and 6

Código de la actividad económica. Este valor puede ser consultado en el endpoint → /consultarActividadEconomica

estado

string

enum

Estado del tercero.

Valores permitidos: AC = Activo, SU = Suspendido

Allowed:

direccion

string

length between 1 and 30

Dirección principal del tercero.

direccion2

string

length between 1 and 30

Dirección secundaria del tercero.

codigoCiudad

string

length between 1 and 5

Código de la ciudad. Este valor puede ser consultado en el endpoint → /consultarCiudad

telefono

string

length between 1 and 22

Teléfono principal.

telefono2

string

length between 1 and 22

Teléfono secundario.

telefono3

string

length between 1 and 22

Teléfono adicional.

fax

string

length between 1 and 22

Número de fax.

zonaPostal

string

length between 1 and 10

Zona postal.

correo

string

length between 1 and 100

Correo electrónico principal.

correoCompra

string

length between 1 and 100

Correo electrónico de compras.

apartadoAereo

string

length between 1 and 10

Número de apartado aéreo.

terceroTransportador

string

enum

¿Es transportador?

Allowed:

agenteRetenedor

string

enum

¿Es agente retenedor?

Allowed:

granContribuyente

string

enum

¿Es gran contribuyente?

Allowed:

autoretenedor

string

enum

¿Es autoretenedor?

Allowed:

exentoRetencion

string

enum

¿Está exento de retención?

Allowed:

responsableIVA

string

enum

Responsable de IVA.

Valores permitidos: C = Contribuyente, S = Simplificado

Allowed:

responsableActivos

string

enum

¿Responsable de activos?

Allowed:

comentario

string

length between 1 and 255

Comentario adicional.

declaraRenta

string

enum

¿Declarante de renta?

Allowed:

sujPasivoImptoNacionalConsumo

string

enum

¿Sujeto pasivo de impuesto nacional al consumo?

Allowed:

regimenSimpleTributacion

string

enum

¿Acogido al régimen simple de tributación?

Allowed:

comidasUltraprocesadas

string

enum

¿Grava comidas ultraprocesadas?

Allowed:

bebidasAzucaradas

string

enum

¿Grava bebidas azucaradas?

Allowed:

proveedorCI

string

enum

¿Es proveedor C.I.?

Allowed:

Responses

201Todos los terceros fueron creados correctamente

400Error en la validación o al menos un tercero falló en la creación

404Recurso no encontrado

500Error interno inesperado en el servidor