Actualizar un contrato

PUT

/fuec/contracts/{id}

curl --request PUT \
  --url https://api.notiauto.co/v1/fuec/contracts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --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. Se envía el contrato completo. Si ya tiene FUEC expedidos, el número no cambia (ya está impreso en sus 21 dígitos). Los FUEC expedidos no cambian: guardan lo que imprimieron.

Authorizations

• ApiKey

Parameters

Path Parameters

id

required

string format: uuid

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

200

Actualizado

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, número repetido o número de un contrato con FUEC