token: YOUR_API_TOKEN
POST /api/createContrapart HTTP/1.1 Host: api.amlprotektor.com Content-Type: application/json token: YOUR_API_TOKEN
{
"Name": "Nombre de la contraparte",
"TypeIdentification": "Ver tabla de referencia (enviar ID)",
"Identification": "Identificación de la contraparte",
"Address": "Dirección de la contraparte",
"Email": "Correo electrónico de la persona encargada de realizar la Debida Diligencia",
"PhoneNumber": "Celular de la persona encargada de realizar la Debida Diligencia",
"IdRisk": "Ver tabla de referencia (enviar ID)",
"TypeCounterpart": "Ver tabla de referencia (enviar ID)",
"ExpeditionDate": "Fecha de expedición de la cédula en los casos que aplique formato (DD/MM/AAAA)",
"EmailNotification": "Correo electrónico de notificación (existe una contraparte por diligenciar)" ,
"CityName": "Nombre de la Ciudad",
"Country": "Nombre del País",
"State": "Nombre del Departamento",
"DialCodePhoneNumber": "Código telefónico relacionado al celular"
}
★ "TypeIdentification"
| ID | Nombre |
|---|---|
| 1 | CC |
| 2 | CE |
| 3 | NIT |
| 4 | PP |
★ "IdRisk"
| ID | Tipo de flujo |
|---|---|
| 2 | Regular: Este tipo de flujo se determina para todas las contrapartes que se le va a hacer la debida diligencia con todos los pasos |
| 3 | Simplificado: Este tipo de flujo se determina para todas las contrapartes que ya tienen implementado el sistema de SAGRILAFT en su empresa y por ende únicamente se va a pedir el certificado del mismo |
★ "TypeCounterpart"
| ID | Nombre |
|---|---|
| 1 | Cliente |
| 2 | Proveedor |
| 3 | Empleado |
| 4 | Accionista |
| 5 | Contratista |
| 6 | Otro |
{ message: "Error: El token es requerido" }
{ message: "Error: El token enviado no esta asociado a ninguna empresa" }
{ message: "Error: La empresa no cuenta con la funcionalidad activa" }
{ message: "Los siguientes campos son requeridos: Fields" }
{ message: "Error: Field no válido" }
{ message: "Error: Este número de documento ya tiene un proceso en curso" }
{ message: "Error creando la contraparte" }
{ message: "pre-formulario creado correctamente" }
{ message: "Error: El token es requerido" }
{ message: "Error: El token enviado no esta asociado a ninguna empresa" }
{ message: "Error: El token no se encuentra activo" }
{ message: "No existe un formulario asociado a la empresa con el número de documento :numeroDeDocumento" }
{ message: "El formulario no se ha diligenciado en su totalidad" }
{ message: "Error obteniendo información de la contraparte" }
{
"mainInformation": {
"Name": "Nombre",
"TypeIdentification": "Tipo de identificación",
"Identification": "Número de documento",
"Address": "Dirección",
"Email": "ejemplo@dominio.com",
"PhoneNumber": "Celular",
"IdRisk": "Tipo de flujo",
"TypeCounterpart": "Tipo de contraparte",
"ExpeditionDate": "Fecha de expedición",
"FormState": "Estado del formulario",
"DialCodePhoneNumber": "Código telefónico",
"City": "Ciudad",
"Country": "País",
"State": "Departamento"
},
"otherInformation": {
"MainEconomicActivity": "",
"codeCIIU": "",
"AnnualOrdinaryIncome": 0,
"AnnualTotalIncome": 0,
"Assets": 0,
"Liabilities": 0,
"ConceptOthersMonthlyIncome": "",
"PublicResources": 0,
"HoldsPublicOffice": 0,
"PublicRecognition": 0,
"RelationPublicExposed": 0,
"InternationalOperation": 0,
"InternacionalOperationImports": 0,
"InternacionalOperationExports": 0,
"InternationalOperationDescrip": "",
"HasIntFinProducts": 0,
"Investments": 0,
"Transfers": 0,
"FinancialProductsAbroadDescrip": "",
"FlowType": 2,
"tradeWithVirtualAssets": 0,
"tradeWithVirtualAssetsDescrip": ""
},
"dataFinProduct": [
{
"Id": 134,
"ProductTypeName": "N/A",
"ProductNumber": "",
"Entity": "",
"Amount": 0,
"CountryName": "N/A",
"CurrencyName": "N/A"
}
],
"legalRepresentatives": [
{
"Name": "Nombre del representante",
"TypeIdentification": "Tipo de identificación",
"Identification": "Número de documento",
"PlaceOfBirth": "Lugar de nacimiento",
"ExpeditionDate": "Fecha de expedición",
"DateBorn": "Fecha de nacimiento",
"Address": "Dirección ",
"PhoneNumber": "Celular",
"Occupation": "Cargo",
"Principal": "SI o NO",
"PublicResource": "0",
"Political": "0"
}
],
"boardDirectors": [
{
"Name": "Nombre del miembro de la junta directiva",
"TypeIdentification": "Tipo de identificación",
"Identification": "Número de documento",
"City": "Ciudad Junta directiva",
"ExpeditionDate": "Fecha de expedición",
"PhoneNumber": "Celular",
"Principal": "SI o NO "
}
],
"shareholders": [
{
"Name": "Nombre del accionista",
"Actions": Cantidad de acciones,
"TypeIdentification": "Tipo de documento",
"Identification": "Número de documento",
"ExpeditionDate": "Fecha de expedición",
"PublicResource": "NO",
"Political": "0",
"Partner": "Empresa socia"
}
],
"taxAuditors": {
"Name": "Nombre",
"TypeIdentification": "Tipo de identifcación",
"Identification": "Número de documento",
"City": "Ciudad",
"ExpeditionDate": "Fecha de expedición",
"PhoneNumber": "Celular"
},
"queries": [
{
"documentNumber": "Número de documento (Consulta)",
"typeDoc": "Tipo de identificación (Consulta)",
"name": "Nombre (Consulta)",
"findings": {
"altos": [],
"bajos": [],
"infos": [],
"medios": []
},
"errors": "Fuentes con errores"
}
]
}
{
"success": false,
"error": {
"code": "TOKEN_REQUIRED",
"message": "El token es requerido"
}
}
{
"success": false,
"error": {
"code": "INVALID_TOKEN",
"message": "El token enviado no es válido"
}
}
{
"success": false,
"error": {
"code": "TOKEN_DISABLED",
"message": "El token no se encuentra activo"
}
}
{
"success": false,
"error": {
"code": "FORM_NOT_FOUND",
"message": "No existe un formulario asociado al documento :numeroDeDocumento"
}
}
{
"success": false,
"error": {
"code": "FORM_NOT_COMPLETED",
"message": "El formulario aún no se ha diligenciado en su totalidad"
}
}
{
"success": false,
"error": {
"code": "INTERNAL_ERROR",
"message": "Ocurrió un error interno procesando la solicitud"
}
}
{
"success": true,
"data": {
"nombreFormulario": "Formulario Persona Natural",
"nombreContraparte": "Juan Pérez",
"identificacion": "123456789",
"estado": "Aprobado",
"fechaCreacion": "25/02/2026 03:20 PM",
"respuestaJSON": { }
}
}