Actualizar formulario de afiliación

POST

https://apis.ecorpa.com

formularios

afiliacion

actualizar

curl -sS -X POST "https://apis.ecorpa.com/v2/formularios/afiliacion/actualizar" \
  -H "Authorization: Bearer ecorpa_key_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "AceptarTerminos": true,
    "Entidad": "formularios_eps",
    "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": "1850905",
        "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": "",
        "CodigoEntidadEps": "EPS037"
      }
    ]
  }'

{
  "Success": true,
  "Message": "Su solicitud fue recibida y está en proceso.",
  "Data": {
    "Entidad": "formularios_eps",
    "Total": 1,
    "IdSolicitud": "c565a29b-2c59-440f-9b0f-b19e2f586b92",
    "Registros": [
      {
        "NumeroIdentificacion": "1020304050",
        "NumeroContrato": "CTR1020304050"
      }
    ],
    "RegistrosRechazados": []
  }
}

Mismo body que crear. Ubica el formulario por NumeroContrato y envía el registro completo. NumeroContrato no se puede cambiar.

Si hay cambios → se encola y consume 1 crédito.
Si no hay cambios o el contrato no existe → RegistrosRechazados.

Scope: formularios_afiliacion.

Probar desde aquí usa tu API Key y consume créditos si el registro se acepta.

boolean

required

Debe ser true.

string

required

formularios_eps, formularios_ccf o formularios_eps_ccf.

boolean

default:"false"

Si es true, el archivo también queda en la plataforma.

boolean

default:"false"

Si es true, envía el PDF por correo.

boolean

default:"false"

Incluye firma del trabajador.

boolean

default:"false"

Incluye firma del cliente.

boolean

default:"false"

Incluye ARL en el formulario.

object[]

required

Registro completo. El contrato se ubica con NumeroContrato y ese valor no se cambia. Cada aceptado consume 1 crédito.

Show properties

string

required

Código del tipo. Mayúsculas.

string

required

Solo dígitos.

string

required

Se normaliza a mayúsculas.

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.

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

Se normaliza a minúsculas.

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. Ubica el formulario. No se puede cambiar.

string

dd/mm/yyyy o "".

string

Obligatorio si Entidad incluye EPS.

string

Obligatorio si Entidad incluye CCF.

string

UUID. Solo si hubo registros aceptados.

object[]

Aceptados.

object[]

No se procesan. Traen Motivos.

curl -sS -X POST "https://apis.ecorpa.com/v2/formularios/afiliacion/actualizar" \
  -H "Authorization: Bearer ecorpa_key_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "AceptarTerminos": true,
    "Entidad": "formularios_eps",
    "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": "1850905",
        "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": "",
        "CodigoEntidadEps": "EPS037"
      }
    ]
  }'

{
  "Success": true,
  "Message": "Su solicitud fue recibida y está en proceso.",
  "Data": {
    "Entidad": "formularios_eps",
    "Total": 1,
    "IdSolicitud": "c565a29b-2c59-440f-9b0f-b19e2f586b92",
    "Registros": [
      {
        "NumeroIdentificacion": "1020304050",
        "NumeroContrato": "CTR1020304050"
      }
    ],
    "RegistrosRechazados": []
  }
}

curl -sS -X POST "https://apis.ecorpa.com/v2/formularios/afiliacion/actualizar" \
  -H "Authorization: Bearer ecorpa_key_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "AceptarTerminos": true,
    "Entidad": "formularios_eps",
    "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": "1850905",
        "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": "",
        "CodigoEntidadEps": "EPS037"
      }
    ]
  }'

{
  "Success": true,
  "Message": "Su solicitud fue recibida y está en proceso.",
  "Data": {
    "Entidad": "formularios_eps",
    "Total": 1,
    "IdSolicitud": "c565a29b-2c59-440f-9b0f-b19e2f586b92",
    "Registros": [
      {
        "NumeroIdentificacion": "1020304050",
        "NumeroContrato": "CTR1020304050"
      }
    ],
    "RegistrosRechazados": []
  }
}

Consultas seguridad social

Consulta de antecedentes

Formularios de afiliación

Afiliaciones seguridad social

Extractor de documentos

Avisos

Actualizar formulario de afiliación