Crear formulario
Crea o completa un formulario de afiliación EPS y/o CCF.
POST
https://apis.ecorpa.com
/
v2
/
formularios
/
afiliacion
curl -sS -X POST "https://apis.ecorpa.com/v2/formularios/afiliacion" \
-H "Authorization: Bearer ecorpa_key_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"AceptarTerminos": true,
"Entidad": "formularios_eps",
"EnviarCorreo": true,
"FirmaTrabajador": true,
"FirmaCliente": 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": "",
"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": [
{
"TipoDocumentoIdentificacion": "CC",
"NumeroIdentificacion": "1020304050",
"Nombres": "JUAN PEREZ",
"NumeroContrato": "CTR1020304050",
"CodigoEntidadEps": "EPS037"
}
],
"RegistrosRechazados": []
}
}
Crea el formulario o completa el que ya existe si al mismo contrato le faltaba la otra entidad. Para cambiar datos de un formulario ya lleno usa actualizar.
Scope:
formularios_afiliacion. Guía: Formularios de afiliación. Códigos e instructivo: en la App, con tu usuario.
Probar desde aquí usa tu API Key y consume créditos por cada registro aceptado.
boolean
required
Debe ser
true.string
required
formularios_eps, formularios_ccf o formularios_eps_ccf.boolean
default:"false"
Si es
true, el PDF también se sube a Drive.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
Trabajadores. Mínimo 1. Cada aceptado consume 1 crédito.
NumeroContrato es único y no se cambia después.Show properties
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. Único.
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" \
-H "Authorization: Bearer ecorpa_key_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"AceptarTerminos": true,
"Entidad": "formularios_eps",
"EnviarCorreo": true,
"FirmaTrabajador": true,
"FirmaCliente": 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": "",
"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": [
{
"TipoDocumentoIdentificacion": "CC",
"NumeroIdentificacion": "1020304050",
"Nombres": "JUAN PEREZ",
"NumeroContrato": "CTR1020304050",
"CodigoEntidadEps": "EPS037"
}
],
"RegistrosRechazados": []
}
}
⌘I
curl -sS -X POST "https://apis.ecorpa.com/v2/formularios/afiliacion" \
-H "Authorization: Bearer ecorpa_key_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"AceptarTerminos": true,
"Entidad": "formularios_eps",
"EnviarCorreo": true,
"FirmaTrabajador": true,
"FirmaCliente": 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": "",
"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": [
{
"TipoDocumentoIdentificacion": "CC",
"NumeroIdentificacion": "1020304050",
"Nombres": "JUAN PEREZ",
"NumeroContrato": "CTR1020304050",
"CodigoEntidadEps": "EPS037"
}
],
"RegistrosRechazados": []
}
}