NomiCheck

{
  "protocolVersion": "0.3.0",
  "name": "NomiCheck",
  "description": "Colombian payroll law as a dated, verifiable catalog \u2014 plus the engine that applies it. The catalog is the substrate: every statutory parameter (minimum wage, transport allowance, UVT, night and Sunday premiums, the ordinary-hour divisor, social security rates, garnishment and withholding caps) resolvable on ANY date since 2020, each with the decree or resolution that set it and the window it was in force. The numbers are public; the maintained, sourced, signed history is not. On top of it, five deterministic calculators \u2014 payroll, withholding tax, payslip verification, final settlement and USDC payout. Every response cites its legal basis (CST, E.T. art. 383/388), carries the sha256 of the catalog that produced it, and is signed with Ed25519, so a third party can verify it offline without trusting the issuer. Stateless by design: input JSON is processed in memory and discarded, never written to a database (Ley 1581/2012 habeas data).",
  "url": "https://nomicheck.ynt.codes/api/batch",
  "version": "1.0.0",
  "preferredTransport": "HTTP+JSON",
  "documentationUrl": "https://nomicheck.ynt.codes/api/batch/health",
  "provider": {
    "organization": "Ynt-labs",
    "url": "https://ynt.codes",
    "contactEmail": "ynt.val@gmail.com"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "supportsAuthenticatedExtendedCard": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/csv"
  ],
  "skills": [
    {
      "id": "legal-parameters",
      "name": "Colombian payroll legal parameters, by date",
      "description": "Returns the Colombian statutory payroll and tax parameters in force on ANY given date - minimum wage, transport allowance, UVT, night/Sunday premiums, the ordinary-hour divisor, social security rates, garnishment and withholding caps - each with its unit, its legal source and the decree or resolution that set it. Pass `?fecha=YYYY-MM-DD` to resolve against the dated history seeded from 2020; omit it for today. The numbers themselves are public: what is not public is the maintained, dated, sourced history, signed with Ed25519 and carrying the sha256 of the catalog that produced it - so an auditor can cite what was in force on the day of a retroactive settlement without trusting the party that computed it. Keys with no value on the requested date are named in `noVigentes` with the reason, never silently dropped.",
      "tags": [
        "payroll",
        "colombia",
        "legal-parameters",
        "historical",
        "by-date",
        "verifiable-output",
        "ed25519"
      ],
      "examples": [
        "What was the Colombian minimum wage and transport allowance on 2024-03-15?",
        "Give me the UVT and withholding caps in force in June 2021",
        "I need signed proof of the ordinary-hour divisor that applied in 2023"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "withholding-tax",
      "name": "Colombian withholding tax (retencion en la fuente)",
      "description": "Computes monthly withholding tax per person from numeric parameters only. Input is fully anonymous: no name, no national ID. Returns the taxable base in COP and UVT, the withholding amount, and the legal reference for each line.",
      "tags": [
        "payroll",
        "tax",
        "colombia",
        "deterministic",
        "anonymous-input"
      ],
      "examples": [
        "Compute withholding for a 8,000,000 COP monthly salary, non-declarant",
        "Batch of 50 employees with dependents and prepaid medicine deductions"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/csv"
      ]
    },
    {
      "id": "payslip-precheck",
      "name": "Payslip pre-check (free, no payment required)",
      "description": "Free triage of the same payslips: returns HOW MANY have discrepancies and the estimated net impact in COP, with the rule-catalog hash it was measured against \u2014 but never which line or which statute, which is the paid report. Same deterministic engine as the paid endpoint: if the pre-check says N, the report finds N. Free by design, not by promotion: a verifier that charges according to what it finds has the wrong incentive. If your payslip is clean you find out for free and never pay.",
      "tags": [
        "verification",
        "payroll",
        "colombia",
        "free",
        "triage",
        "no-signup"
      ],
      "examples": [
        "Is there anything wrong with my payslip? (free, no payment)",
        "Triage 300 payslips and tell me how many are worth a paid report"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "payslip-verification",
      "name": "Payslip compliance verification",
      "description": "Independently recalculates the legal lines of a payslip (base salary, transport allowance, health, pension, solidarity fund) and compares them against what the payslip declares. Returns a per-line verdict and the estimated net impact on the worker. Extralegal items are flagged as non-verifiable rather than guessed. Try `payslip-precheck` first: it is free, needs no payment or signup, and tells you whether this paid report would find anything.",
      "tags": [
        "verification",
        "payroll",
        "colombia",
        "audit",
        "compliance",
        "signed-evidence",
        "ed25519"
      ],
      "examples": [
        "Does this payslip comply with 2026 Colombian labor law?",
        "Verify 200 payslips and flag underpayments"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/csv"
      ]
    },
    {
      "id": "payroll-settlement",
      "name": "Full payroll settlement",
      "description": "Complete payroll run for a company: accruals, deductions, overtime and night/holiday surcharges, social security contributions. Each line carries its legal reference and the batch carries the rule-catalog hash.",
      "tags": [
        "payroll",
        "colombia",
        "batch",
        "settlement"
      ],
      "examples": [
        "Settle July 2026 payroll for 120 employees"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/csv"
      ]
    },
    {
      "id": "final-settlement",
      "name": "Colombian final settlement (liquidacion de contrato)",
      "description": "Computes what an employer owes a worker when a contract ends: accrued severance (cesantias), its statutory 12% interest, the pro-rata statutory bonus (prima) and unused vacation, plus dismissal indemnity when requested. Each concept is settled from its OWN cut-off date, because they are not paid on the same cycle - settling them all from the hire date is the classic spreadsheet error and pays twice for what was already paid. The caller declares the payment history (cortePrima, corteCesantias, diasVacacionesTomados); anything not declared is assumed to be the simple case and the assumption is returned explicitly in `supuestos`, never silently. Transport allowance is sent as a right (boolean), not an amount: the server resolves the figure that was in force on the termination date from the signed rule catalog, so retroactive settlements use period-correct values. Returns one line per concept with its legal citation.",
      "tags": [
        "payroll",
        "colombia",
        "severance",
        "termination",
        "settlement",
        "retroactive",
        "deterministic"
      ],
      "examples": [
        "Settle a contract that ran from March 2024 to July 2026, prima already paid through June",
        "Final settlement for 40 employees laid off in the same month, with indemnity",
        "What is owed to someone dismissed during the probation period?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/csv"
      ]
    },
    {
      "id": "usdc-contractor-payout",
      "name": "Non-custodial USDC contractor payout batch",
      "description": "Converts COP amounts to USDC using the official TRM rate from datos.gov.co, frozen with a sha256 hash and an expiry window so the rate is auditable after the fact. Produces EIP-681 payment links and a Gnosis Safe batch JSON. The payer signs from their own wallet; this service never holds or moves funds.",
      "tags": [
        "payments",
        "usdc",
        "base",
        "non-custodial",
        "eip-681",
        "gnosis-safe"
      ],
      "examples": [
        "Pay 30 Colombian contractors in USDC on Base with a frozen TRM rate"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/csv"
      ]
    }
  ],
  "securitySchemes": {},
  "security": [],
  "supportedInterfaces": [
    {
      "transport": "HTTP+JSON",
      "url": "https://nomicheck.ynt.codes/api/batch"
    }
  ],
  "additionalInterfaces": [
    {
      "transport": "HTTP+JSON",
      "url": "https://nomicheck.ynt.codes/api/batch"
    }
  ],
  "x-executor": {
    "marketplace": "https://execution.market",
    "executorId": "a9b6d20d-bf89-4e9a-a4b3-6633bd7263d6",
    "walletAddress": "0xb345895e8B5EB66A3480641674cbEb878E0b0070",
    "identity": {
      "standard": "ERC-8004",
      "agentId": 59771,
      "network": "base",
      "chainId": 8453,
      "registryAddress": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
      "registrationTx": "0x2c26cbd5f500b9803cd13f547963d96876c3e36080f2e43970e8b86b94471b7f"
    },
    "humanInTheLoop": true,
    "aiUsagePolicy": {
      "uri": "ipfs://bafkreicxw57se2524kigtqvcaueet4iyhsq4juzc6ljqvmccdyu3fhg2fu",
      "gateway": "https://orange-sophisticated-amphibian-58.mypinata.cloud/ipfs/bafkreicxw57se2524kigtqvcaueet4iyhsq4juzc6ljqvmccdyu3fhg2fu",
      "sha256": "57b77f226bbae29069c2a2050849f118",
      "updatedAt": "2026-07-28"
    }
  },
  "x-verification": {
    "outputSignature": {
      "algorithm": "ed25519",
      "publicKeyEndpoint": "https://nomicheck.ynt.codes/api/batch/publickey",
      "canonicalization": "sorted_keys_utf8_json",
      "covers": "all_fields_except_signature",
      "note": "Every response is signed. The public key is published so a buyer can verify a delivery offline, without contacting this server."
    },
    "ruleCatalog": {
      "hashEndpoint": "https://nomicheck.ynt.codes/api/batch/health",
      "verifiedAt": "2026-07-16",
      "note": "Each output embeds the sha256 of the legal rule catalog used, so a buyer can confirm which rules produced the numbers."
    },
    "exchangeRate": {
      "verifyEndpoint": "https://nomicheck.ynt.codes/api/tasa/verify",
      "source": "datos.gov.co dataset 32sa-8pi3 (TRM oficial)"
    },
    "jsonSchemas": {
      "withholdingTax": "https://nomicheck.ynt.codes/api/batch/retencion/schema/v1.json",
      "payslipVerification": "https://nomicheck.ynt.codes/api/batch/verificar/schema/v1.json",
      "payrollSettlement": "https://nomicheck.ynt.codes/api/batch/schema/v1.json",
      "usdcPayout": "https://nomicheck.ynt.codes/api/batch/pago-onchain/schema/v1.json"
    }
  },
  "x-compliance": {
    "jurisdiction": "CO",
    "dataProtection": {
      "law": "Ley 1581 de 2012 (habeas data, Colombia)",
      "persistsToDatabase": false,
      "processedByExternalLlm": false,
      "note": "The batch endpoints are stateless. Each signed output carries a habeasData attestation, so the guarantee is verifiable rather than merely stated."
    },
    "disclaimer": "Informational output. Not an accounting opinion under Ley 43 de 1990."
  }
}