Crear

El endpoint de registro de tercero y usuario permite crear un nuevo tercero en el sistema. Este proceso es esencial para asegurar que todos los datos relevantes de los terceros y usuarios se capturen y gestionen correctamente.

Parámetros para el Endpoint

A continuación se detallan los parámetros necesarios para registrar un nuevo tercero y usuario:

Objeto para el envío de datos.

{  
    "tradeName": "OFFICWEE COL",  
    "legalName": "OFFIC",  
    "document": "324232323",  
    "typeDocumentId": "3",  
    "dv": "7",  
    "emailNotification": "[email protected]",  
    "indicativeContact": "+57",  
    "phoneContact": "3000090987",  
    "categoryId": "3",  
    "address": "7217 NW 2nd Ave",
    "thirdDirectory": {  
        "name": "juan C",  
        "lastName": "Armeria",  
        "document": "55625685",  
        "typeDocumentId": 1,  
        "emailNotification": "[email protected]",  
        "indicativeContact": "+57",  
        "phoneContact": "30000909875",  
        "categoryId": 3,  
        "address": "7217 NW 2nd Ave",
        "thirdCredentials": {  
            "type": "CARD",  
            "fullName": "Pepito Perez",   
            "accountNumber": "99999999",  
            "expirationDate": "203112"  
        }  
    }  
}

Explicación de tabla.
PN: Persona Natural
PJ: Persona Jurídica

PARÁMETRO	DESCRIPCIÓN	PN	PJ
name	Nombre de pila de la persona.	`X`
lastName	Apellido de la persona.	`X`
tradeName	solo cuando el tipo de documento es 3(NIT) Nombre bajo el que se desarrolla la actividad comercial. En este caso, podría ser el nombre de un negocio o emprendimiento.		`X`
legalName	solo cuando el tipo de documento es 3(NIT) Nombre oficial registrado ante las autoridades. En este caso, podría ser la razón social de una empresa.		`X`
document	Número de documento del tercero principal.	`X`	`X`
typeDocumentId	ID del tipo de documento del tercero principal.	`X`	`X`
dv	Dígito de verificación del documento (solo si el tipo de documento lo requiere).		`X`
emailNotification	Dirección de correo electrónico para notificaciones del tercero principal.	`X`	`X`
indicativeContact	Indicativo de país para el número de teléfono de contacto del tercero principal.	`X`	`X`
phoneContact	Número de teléfono de contacto del tercero principal.	`X`	`X`
categoryId	ID de la categoría del tercero principal.	`X`	`X`
address	Dirección física del usuario tercero principal.	`X`	`X`
thirdDirectory.name	Nombre de pila de la persona.	`X`
thirdDirectory.lastName	Apellido de la persona.	`X`
thirdDirectory.tradeName	solo cuando el tipo de documento es 3(NIT) Nombre bajo el que se desarrolla la actividad comercial. En este caso, podría ser el nombre de un negocio o emprendimiento.		`X`
thirdDirectory.legalName	solo cuando el tipo de documento es 3(NIT) Nombre oficial registrado ante las autoridades. En este caso, podría ser la razón social de una empresa.		`X`
thirdDirectory.document	Documento del usuario tercero.	`X`	`X`
thirdDirectory.typeDocumentId	ID del tipo de documento del usuario tercero.	`X`	`X`
thirdDirectory.dv	Dígito de verificación del documento del usuario tercero (solo si el tipo de documento lo requiere).		`X`
thirdDirectory.emailNotification	Dirección de correo electrónico para notificaciones del usuario tercero.	`X`	`X`
thirdDirectory.indicativeContact	Indicativo de país para el número de teléfono de contacto del usuario tercero.	`X`	`X`
thirdDirectory.phoneContact	Número de teléfono de contacto del usuario tercero.	`X`	`X`
thirdDirectory.categoryId	ID de la categoría del usuario tercero.	`X`	`X`
thirdDirectory.address	Dirección física del usuario tercero.	`X`	`X`
thirdDirectory.thirdCredentials.type	Tipo de credencial utilizada para las transacciones (ej., tarjeta, cuenta bancaria).	`X`	`X`
thirdDirectory.thirdCredentials.fullName	Nombre completo del titular de la credencial del usuario tercero.	`X`	`X`
thirdDirectory.thirdCredentials.accountNumber	Número de cuenta o tarjeta del usuario tercero.	`X`	`X`
thirdDirectory.thirdCredentials.expirationDate	Fecha de expiración de la tarjeta del usuario tercero en formato YYYYMM.	`X`	`X`