Crear o reprocesar

POST

https://apis.ecorpa.com

afiliaciones

seguridad_social

curl -sS -X POST "https://apis.ecorpa.com/v2/afiliaciones/seguridad_social" \
  -H "Authorization: Bearer ecorpa_key_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "AceptarTerminos": true,
    "Entidad": "afiliaciones_seguridad_social_eps",
    "Canal": "plataforma",
    "FirmaTrabajador": true,
    "FirmaCliente": true,
    "RastrearCertificado": true,
    "Registros": [
      {
        "TipoDocumentoIdentificacion": "CC",
        "NumeroIdentificacion": "1020304050",
        "Nombres": "JUAN PEREZ",
        "Genero": "MAS",
        "CodigoNacionalidad": "170",
        "CodigoPaisNacimiento": "170",
        "FechaNacimiento": "11/05/1997",
        "CodigoDaneCiudadNacimiento": "11001",
        "FechaIngreso": "03/08/2026",
        "Afp": "PROTECCION S.A.",
        "Arl": "COLPATRIA",
        "Ibc": "1750905",
        "DireccionResidencia": "CALLE 1 # 2-3",
        "Celular": "3001234567",
        "CorreoElectronico": "ejemplo@correo.com",
        "CodigoDaneCiudadResidencia": "11001",
        "BarrioResidencia": "CENTRO",
        "CodigoDaneCiudadLabor": "11001",
        "DireccionLabor": "CALLE 4 # 5-6",
        "BarrioLabor": "CENTRO",
        "NitEmpresa": "900123456",
        "Cargo": "AUXILIAR",
        "FechaExpedicionDocumentoIdentidad": "19/05/2015",
        "CodigoDaneCiudadExpedicionDocumentoIdentidad": "11001",
        "NumeroContrato": "CTR1020304050",
        "FechaRetiroUltimoContrato": "",
        "CodigoEntidad": "EPS037"
      }
    ]
  }'

{
  "Success": true,
  "Message": "Solicitud recibida: se crearon registros nuevos y se retomaron reprocesos. Todo quedó en cola.",
  "Data": {
    "IdSolicitud": "657175d1-80dc-4f5a-98a3-debebc49bba5",
    "Entidad": "afiliaciones_seguridad_social_eps",
    "Total": 1,
    "Registros": [
      {
        "NumeroIdentificacion": "1020304050",
        "NumeroContrato": "CTR1020304050",
        "CodigoEntidad": "EPS037",
        "Canal": "plataforma"
      }
    ],
    "RegistrosReproceso": [],
    "RegistrosRechazados": []
  }
}

Clasifica cada ítem en la misma respuesta: nuevo (Registros), reproceso (RegistrosReproceso) o rechazo (RegistrosRechazados). Scope: afiliaciones_seguridad_social. Guía: Afiliaciones seguridad social. Códigos e instructivo: en la App, con tu usuario.

Probar desde aquí usa tu API Key y consume créditos por cada registro nuevo o reproceso aceptado.

boolean

required

Debe ser true.

string

required

afiliaciones_seguridad_social_eps, afiliaciones_seguridad_social_ccf, afiliaciones_seguridad_social_arl o afiliaciones_seguridad_social_afp.

string

Default del lote: plataforma o asesor. Si un registro trae Canal, ese gana.

boolean

default:"false"

Envía con documento de identidad.

boolean

default:"false"

Envía con formulario.

boolean

default:"false"

Incluye firma del trabajador.

boolean

default:"false"

Incluye firma del cliente.

boolean

default:"false"

Si es true, el proceso puede seguir hasta certificado.

object[]

required

Trabajadores. Mínimo 1. Cada nuevo o reproceso aceptado consume 1 crédito.

Show properties

string

required

Código del tipo. Mayúsculas.

string

required

Solo dígitos.

string

required

Nombre completo.

string

required

Catálogo (ej. FEM, MAS).

string

required

Código de país.

string

required

Código de país.

string

required

dd/mm/yyyy.

string

required

5 dígitos.

string

required

dd/mm/yyyy. No puede ser futura.

string

required

Nombre de la AFP.

string

required

Nombre de la ARL.

string

required

Valor IBC.

string

required

Dirección de residencia.

string

required

10 dígitos.

string

required

Email.

string

required

5 dígitos.

string

required

Barrio de residencia.

string

required

5 dígitos.

string

required

Dirección laboral.

string

required

Barrio laboral.

string

required

NIT de la empresa. Solo dígitos.

string

required

Cargo.

string

required

dd/mm/yyyy.

string

required

5 dígitos.

string

required

Letras y números.

string

dd/mm/yyyy o "".

string

required

Código de la EPS, CCF, ARL o AFP, según Entidad.

string

plataforma o asesor. Sobrescribe el canal de la raíz para este registro.

string

UUID. Solo si hubo al menos un nuevo o reproceso.

object[]

Nuevos aceptados.

object[]

Reprocesos aceptados. Pueden traer Cambios y estados anteriores.

object[]

No se procesan. Traen Motivos. HTTP sigue siendo 200.

curl -sS -X POST "https://apis.ecorpa.com/v2/afiliaciones/seguridad_social" \
  -H "Authorization: Bearer ecorpa_key_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "AceptarTerminos": true,
    "Entidad": "afiliaciones_seguridad_social_eps",
    "Canal": "plataforma",
    "FirmaTrabajador": true,
    "FirmaCliente": true,
    "RastrearCertificado": true,
    "Registros": [
      {
        "TipoDocumentoIdentificacion": "CC",
        "NumeroIdentificacion": "1020304050",
        "Nombres": "JUAN PEREZ",
        "Genero": "MAS",
        "CodigoNacionalidad": "170",
        "CodigoPaisNacimiento": "170",
        "FechaNacimiento": "11/05/1997",
        "CodigoDaneCiudadNacimiento": "11001",
        "FechaIngreso": "03/08/2026",
        "Afp": "PROTECCION S.A.",
        "Arl": "COLPATRIA",
        "Ibc": "1750905",
        "DireccionResidencia": "CALLE 1 # 2-3",
        "Celular": "3001234567",
        "CorreoElectronico": "ejemplo@correo.com",
        "CodigoDaneCiudadResidencia": "11001",
        "BarrioResidencia": "CENTRO",
        "CodigoDaneCiudadLabor": "11001",
        "DireccionLabor": "CALLE 4 # 5-6",
        "BarrioLabor": "CENTRO",
        "NitEmpresa": "900123456",
        "Cargo": "AUXILIAR",
        "FechaExpedicionDocumentoIdentidad": "19/05/2015",
        "CodigoDaneCiudadExpedicionDocumentoIdentidad": "11001",
        "NumeroContrato": "CTR1020304050",
        "FechaRetiroUltimoContrato": "",
        "CodigoEntidad": "EPS037"
      }
    ]
  }'

{
  "Success": true,
  "Message": "Solicitud recibida: se crearon registros nuevos y se retomaron reprocesos. Todo quedó en cola.",
  "Data": {
    "IdSolicitud": "657175d1-80dc-4f5a-98a3-debebc49bba5",
    "Entidad": "afiliaciones_seguridad_social_eps",
    "Total": 1,
    "Registros": [
      {
        "NumeroIdentificacion": "1020304050",
        "NumeroContrato": "CTR1020304050",
        "CodigoEntidad": "EPS037",
        "Canal": "plataforma"
      }
    ],
    "RegistrosReproceso": [],
    "RegistrosRechazados": []
  }
}

⌘I

curl -sS -X POST "https://apis.ecorpa.com/v2/afiliaciones/seguridad_social" \
  -H "Authorization: Bearer ecorpa_key_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "AceptarTerminos": true,
    "Entidad": "afiliaciones_seguridad_social_eps",
    "Canal": "plataforma",
    "FirmaTrabajador": true,
    "FirmaCliente": true,
    "RastrearCertificado": true,
    "Registros": [
      {
        "TipoDocumentoIdentificacion": "CC",
        "NumeroIdentificacion": "1020304050",
        "Nombres": "JUAN PEREZ",
        "Genero": "MAS",
        "CodigoNacionalidad": "170",
        "CodigoPaisNacimiento": "170",
        "FechaNacimiento": "11/05/1997",
        "CodigoDaneCiudadNacimiento": "11001",
        "FechaIngreso": "03/08/2026",
        "Afp": "PROTECCION S.A.",
        "Arl": "COLPATRIA",
        "Ibc": "1750905",
        "DireccionResidencia": "CALLE 1 # 2-3",
        "Celular": "3001234567",
        "CorreoElectronico": "ejemplo@correo.com",
        "CodigoDaneCiudadResidencia": "11001",
        "BarrioResidencia": "CENTRO",
        "CodigoDaneCiudadLabor": "11001",
        "DireccionLabor": "CALLE 4 # 5-6",
        "BarrioLabor": "CENTRO",
        "NitEmpresa": "900123456",
        "Cargo": "AUXILIAR",
        "FechaExpedicionDocumentoIdentidad": "19/05/2015",
        "CodigoDaneCiudadExpedicionDocumentoIdentidad": "11001",
        "NumeroContrato": "CTR1020304050",
        "FechaRetiroUltimoContrato": "",
        "CodigoEntidad": "EPS037"
      }
    ]
  }'

{
  "Success": true,
  "Message": "Solicitud recibida: se crearon registros nuevos y se retomaron reprocesos. Todo quedó en cola.",
  "Data": {
    "IdSolicitud": "657175d1-80dc-4f5a-98a3-debebc49bba5",
    "Entidad": "afiliaciones_seguridad_social_eps",
    "Total": 1,
    "Registros": [
      {
        "NumeroIdentificacion": "1020304050",
        "NumeroContrato": "CTR1020304050",
        "CodigoEntidad": "EPS037",
        "Canal": "plataforma"
      }
    ],
    "RegistrosReproceso": [],
    "RegistrosRechazados": []
  }
}

Consultas seguridad social

Consulta de antecedentes

Formularios de afiliación

Afiliaciones seguridad social

Crear o reprocesar