Registrar un contrato

POST

/fuec/contracts

curl --request POST \
  --url https://api.notiauto.co/v1/fuec/contracts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "number": 256, "contractor_name": "example", "contractor_document_type": "N", "contractor_document": "example", "service_type": "students", "purpose": "example", "origin_destination": "example", "agreement_company": "example", "agreement_company_nit": "example", "full_disposal": false, "starts_on": "2026-04-15", "ends_on": "2026-04-15", "responsible_name": "example", "responsible_document": "example", "responsible_phone": "example", "responsible_address": "example" }'

• Producción

Requiere el scope fuec.write. Sin number, toma el siguiente de la organización.

Authorizations

• ApiKey

Request Body^required

Media typeapplication/json

FuecContractInput

object

number

Número del contrato, único en la organización. Al crear, si no va, se usa el siguiente

integer

Example

256

contractor_name

required

string

<= 200 characters

contractor_document_type

required

C, E, N (NIT), P, U, T, D o Y

string

Example

N

contractor_document

required

string

<= 20 characters

service_type

required

string

Allowed values: students employees tourists health specific_group

purpose

required

El objeto, igual al del contrato firmado

string

<= 500 characters

origin_destination

required

string

<= 500 characters

agreement_company

string

nullable <= 200 characters

agreement_company_nit

string

nullable <= 20 characters

full_disposal

boolean

starts_on

required

string format: date

ends_on

required

string format: date

responsible_name

string

nullable <= 150 characters

responsible_document

string

nullable <= 20 characters

responsible_phone

string

nullable <= 30 characters

responsible_address

string

nullable <= 200 characters

Responses

201

Registrado

Media typeapplication/json

object

success

boolean

data

FuecContract

object

id

string format: uuid

number

integer

contractor_name

string

contractor_document_type

string

contractor_document

string

service_type

string

Allowed values: students employees tourists health specific_group

purpose

string

origin_destination

string

agreement_company

string

nullable

agreement_company_nit

string

nullable

full_disposal

boolean

starts_on

string format: date

ends_on

string format: date

state

string

Allowed values: upcoming active ended

responsible

object

name

string

nullable

document

string

nullable

phone

string

nullable

address

string

nullable

extracts_count

integer

Example

{
  "success": true,
  "data": {
    "number": 255,
    "contractor_name": "Colegio Los Andes",
    "contractor_document_type": "N",
    "contractor_document": "800123456",
    "service_type": "students",
    "purpose": "Contrato para transporte de estudiantes",
    "origin_destination": "Bogotá perímetro urbano",
    "state": "upcoming",
    "extracts_count": 3
  }
}

422

Datos inválidos o número repetido