API de marcayliquida

Authorization: Bearer fmk_a1b2c3d4e5f6...
Content-Type: application/json

# alternativa
x-api-key: fmk_a1b2c3d4e5f6...
Content-Type: application/json

https://marcayliquida.com/api/v1

{
  "ok": false,
  "error": {
    "codigo": "datos_invalidos",
    "mensaje": "Los datos del trabajador no son válidos.",
    "detalles": [
      { "campo": "salario_base", "mensaje": "El salario base debe ser mayor que cero." },
      { "campo": "fecha_ingreso", "mensaje": "Usa el formato YYYY-MM-DD, por ejemplo 2026-08-05." }
    ]
  }
}

curl -X POST https://marcayliquida.com/api/v1/trabajadores \
  -H "Authorization: Bearer $MARCAYLIQUIDA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "numero_documento": "1098765432",
    "primer_nombre": "Laura",
    "primer_apellido": "Gómez",
    "salario_base": 1600000
  }'

{
  "ok": true,
  "trabajador": {
    "estado": "creado",
    "id_trabajador": 481,
    "info_id": 92,
    "nombre_completo": "LAURA GÓMEZ",
    "tipo_documento": "CC",
    "numero_documento": "1098765432",
    "cargo": null,
    "sede_id": null,
    "dias_dominicales": ["Domingo"],
    "foto_pendiente": true,
    "advertencias": [
      "El trabajador queda sin foto biométrica: captúrala desde la cámara del panel para que pueda marcar por reconocimiento facial.",
      "Sin cargo asignado: las horas no se valorizan hasta que el trabajador tenga un cargo con tarifas configuradas."
    ]
  }
}

{
  "tipo_documento": "CC",
  "numero_documento": "1098765432",
  "primer_nombre": "Laura",
  "segundo_nombre": "Andrea",
  "primer_apellido": "Gómez",
  "segundo_apellido": "Ríos",

  "cargo": "Operario",
  "sede_nombre": "Planta Norte",
  "salario_base": 1600000,
  "valor_hora_ordinaria": 6667,
  "fecha_ingreso": "2026-08-01",
  "tipo_contrato": "INDEFINIDO",
  "dias_dominicales": ["Domingo", "Sábado"],

  "fecha_nacimiento": "1995-03-12",
  "sexo": "F",
  "email": "laura.gomez@empresa.com",
  "celular": "3001234567",
  "departamento_residencia": "Santander",
  "municipio_residencia": "Bucaramanga",
  "direccion_residencia": "Calle 45 # 12-30",
  "departamento_trabajo": "Santander",
  "municipio_trabajo": "Girón",

  "periodicidad_pago": "MENSUAL",
  "forma_pago": "TRANSFERENCIA",
  "auxilio_transporte_aplica": true,
  "salario_integral": false,
  "alto_riesgo": false,
  "subtipo_cotizante": "01",
  "eps_codigo": "EPS037",
  "afp_codigo": "230301",
  "arl_codigo": "14-1",
  "arl_nivel_riesgo": 3,
  "caja_compensacion_codigo": "CCF23",
  "fondo_cesantias_codigo": "230301",
  "banco": "Bancolombia",
  "tipo_cuenta": "AHORROS",
  "numero_cuenta": "12345678901",
  "estado": "ACTIVO",

  "actualizar_si_existe": false
}

curl -X POST https://marcayliquida.com/api/v1/trabajadores/lote \
  -H "Authorization: Bearer $MARCAYLIQUIDA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modo": "parcial",
    "actualizar_si_existe": false,
    "trabajadores": [
      {
        "numero_documento": "1098765432",
        "primer_nombre": "Laura",
        "primer_apellido": "Gómez",
        "cargo": "Operario",
        "salario_base": 1600000,
        "sede_nombre": "Planta Norte"
      },
      {
        "numero_documento": "1102233445",
        "primer_nombre": "Carlos",
        "segundo_nombre": "Andrés",
        "primer_apellido": "Peña",
        "cargo": "Supervisor",
        "salario_base": 2400000,
        "dias_dominicales": ["Domingo", "Sábado"]
      }
    ]
  }'

{
  "ok": true,
  "resumen": { "total": 3, "creados": 2, "actualizados": 0, "errores": 1 },
  "resultados": [
    {
      "indice": 0,
      "estado": "creado",
      "id_trabajador": 481,
      "info_id": 92,
      "nombre_completo": "LAURA GÓMEZ",
      "tipo_documento": "CC",
      "numero_documento": "1098765432",
      "cargo": "Operario",
      "sede_id": 3,
      "dias_dominicales": ["Domingo"],
      "foto_pendiente": true,
      "advertencias": ["El trabajador queda sin foto biométrica: …"]
    },
    {
      "indice": 1,
      "estado": "creado",
      "id_trabajador": 482,
      "info_id": 93,
      "nombre_completo": "CARLOS ANDRÉS PEÑA",
      "tipo_documento": "CC",
      "numero_documento": "1102233445",
      "cargo": "Supervisor",
      "sede_id": null,
      "dias_dominicales": ["Domingo", "Sábado"],
      "foto_pendiente": true,
      "advertencias": []
    },
    {
      "indice": 2,
      "estado": "error",
      "numero_documento": "900",
      "codigo": "datos_invalidos",
      "mensaje": "Los datos del trabajador no son válidos.",
      "detalles": [
        { "campo": "salario_base", "mensaje": "El salario base debe ser mayor que cero." }
      ]
    }
  ]
}

curl -X POST https://marcayliquida.com/api/v1/faltas \
  -H "Authorization: Bearer $MARCAYLIQUIDA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "documento": "1098765432",
    "motivo": "INCAPACIDAD_EPS",
    "fecha_inicio": "2026-08-10",
    "fecha_fin": "2026-08-15",
    "observaciones": "Incapacidad 4471 - Sanitas"
  }'

{
  "ok": true,
  "motivo": {
    "id": 1,
    "codigo": "INCAPACIDAD_EPS",
    "nombre": "Incapacidad EPS",
    "remunerada": true,
    "requiere_soporte": true
  },
  "periodo": { "fecha_inicio": "2026-08-10", "fecha_fin": "2026-08-15", "dias": 6 },
  "resumen": {
    "total": 1,
    "creadas": 1,
    "reemplazadas": 0,
    "omitidas": 0,
    "errores": 0,
    "no_encontrados": 0
  },
  "resultados": [
    {
      "estado": "creada",
      "id_trabajador": 481,
      "nombre": "LAURA GÓMEZ",
      "documento": "1098765432",
      "falta_id": 55
    }
  ],
  "advertencias": [
    "El motivo \"Incapacidad EPS\" requiere comprobante: súbelo desde Faltas en el panel para que la ausencia quede soportada."
  ]
}

{
  "documentos": ["1098765432", "1102233445", "1103344556"],
  "motivo": "VACACIONES",
  "fecha_inicio": "2026-12-20",
  "fecha_fin": "2027-01-05",
  "observaciones": "Cierre de fin de año",
  "en_conflicto": "omitir"
}

const API = 'https://marcayliquida.com/api/v1';
const CLAVE = process.env.MARCAYLIQUIDA_API_KEY;

async function llamar(ruta, cuerpo) {
  const respuesta = await fetch(API + ruta, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${CLAVE}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(cuerpo),
  });

  const datos = await respuesta.json();
  if (!respuesta.ok) {
    // datos.error.codigo es estable; datos.error.detalles dice qué campo falló.
    throw new Error(`${datos.error.codigo}: ${datos.error.mensaje}`);
  }
  return datos;
}

// Alta de un trabajador
const { trabajador } = await llamar('/trabajadores', {
  numero_documento: '1098765432',
  primer_nombre: 'Laura',
  primer_apellido: 'Gómez',
  cargo: 'Operario',
  salario_base: 1600000,
});

// Vacaciones de ese trabajador
await llamar('/faltas', {
  id_trabajador: trabajador.id_trabajador,
  motivo: 'VACACIONES',
  fecha_inicio: '2026-12-20',
  fecha_fin: '2027-01-05',
  en_conflicto: 'omitir',
});

import os
import requests

API = "https://marcayliquida.com/api/v1"
CABECERAS = {
    "Authorization": f"Bearer {os.environ['MARCAYLIQUIDA_API_KEY']}",
    "Content-Type": "application/json",
}

def llamar(ruta: str, cuerpo: dict) -> dict:
    respuesta = requests.post(API + ruta, json=cuerpo, headers=CABECERAS, timeout=30)
    datos = respuesta.json()
    if not respuesta.ok:
        error = datos["error"]
        raise RuntimeError(f"{error['codigo']}: {error['mensaje']}")
    return datos

# Carga masiva desde tu nómina, en bloques de 200
def cargar(trabajadores: list[dict]) -> None:
    for inicio in range(0, len(trabajadores), 200):
        bloque = trabajadores[inicio : inicio + 200]
        datos = llamar(
            "/trabajadores/lote",
            {"trabajadores": bloque, "modo": "parcial", "actualizar_si_existe": True},
        )
        for fila in datos["resultados"]:
            if fila["estado"] == "error":
                print(inicio + fila["indice"], fila["codigo"], fila["mensaje"])