{"version":"1.0.0","tools":[{"name":"get_organization","description":"Get the active organization profile, fiscal identity, readiness, certificate status, global-invoice settings, SAT synchronization, and essential sales defaults.","inputSchema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"name":{"type":"string"},"timeZone":{"type":"string"},"fiscal":{"type":"object","properties":{"legalName":{"$ref":"#/definitions/__schema0"},"rfc":{"$ref":"#/definitions/__schema0"},"taxSystem":{"$ref":"#/definitions/__schema0"},"rfcPersonType":{"$ref":"#/definitions/__schema0"},"usesBorderRegionStimulus":{"type":"boolean"},"website":{"$ref":"#/definitions/__schema0"},"phone":{"$ref":"#/definitions/__schema0"},"address":{"type":"object","properties":{"street":{"$ref":"#/definitions/__schema0"},"city":{"$ref":"#/definitions/__schema0"},"state":{"$ref":"#/definitions/__schema0"},"exterior":{"$ref":"#/definitions/__schema0"},"interior":{"$ref":"#/definitions/__schema0"},"neighborhood":{"$ref":"#/definitions/__schema0"},"municipality":{"$ref":"#/definitions/__schema0"},"postalCode":{"type":"string"}},"required":["postalCode"],"additionalProperties":false}},"additionalProperties":false},"readiness":{"type":"object","properties":{"production":{"type":"boolean"},"csd":{"type":"boolean"},"fiel":{"type":"boolean"}},"required":["production","csd","fiel"],"additionalProperties":false},"certificates":{"type":"object","properties":{"csd":{"type":"object","properties":{"configured":{"type":"boolean"},"expiresAt":{"$ref":"#/definitions/__schema0"},"serialNumber":{"$ref":"#/definitions/__schema0"}},"required":["configured"],"additionalProperties":false},"fiel":{"type":"object","properties":{"configured":{"type":"boolean"},"expiresAt":{"$ref":"#/definitions/__schema0"}},"required":["configured"],"additionalProperties":false}},"required":["csd","fiel"],"additionalProperties":false},"globalInvoice":{"type":"object","properties":{"enabled":{"type":"boolean"},"periodicity":{"$ref":"#/definitions/__schema0"},"eligibilityStartAt":{"allOf":[{"$ref":"#/definitions/__schema1"}]},"lastRunAt":{"allOf":[{"$ref":"#/definitions/__schema1"}]}},"required":["enabled"],"additionalProperties":false},"automation":{"type":"object","properties":{"cfdiSyncEnabled":{"type":"boolean"},"declarationSyncEnabled":{"type":"boolean"}},"required":["cfdiSyncEnabled","declarationSyncEnabled"],"additionalProperties":false},"portal":{"type":"object","properties":{"allowedCfdiUses":{"type":"array","items":{"type":"string"}},"receiptExpirationDays":{"type":"number"},"receiptLocationRequired":{"type":"boolean"}},"required":["receiptLocationRequired"],"additionalProperties":false}},"required":["name","timeZone","fiscal","readiness","certificates","globalInvoice","automation","portal"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string"},"__schema1":{"type":"string","format":"date-time"}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"workspace","order":10,"permissions":["org:read"]}},{"name":"update_organization","description":"Update one coherent organization settings section: profile, fiscal identity, essential sales defaults, automatic global invoice, or SAT synchronization. Read get_organization first.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"oneOf":[{"type":"object","properties":{"section":{"type":"string","const":"profile"},"name":{"type":"string","minLength":1},"timeZone":{"type":"string","minLength":1}},"required":["section"],"additionalProperties":false},{"type":"object","properties":{"section":{"type":"string","const":"fiscal"},"legalName":{"type":"string","minLength":1,"maxLength":100},"rfc":{"type":"string","minLength":12,"maxLength":13},"taxSystem":{"type":"string","enum":["601","603","605","606","607","608","610","611","612","614","615","616","620","621","622","623","624","625","626"],"description":"Active SAT tax-system code.","x-exac-sat-catalog":"tax-systems"},"address":{"type":"object","properties":{"postalCode":{"type":"string","pattern":"^\\d{5}$"},"street":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"exterior":{"type":"string"},"interior":{"type":"string"},"neighborhood":{"type":"string"},"municipality":{"type":"string"}},"required":["postalCode"],"additionalProperties":false},"website":{"type":"string","format":"uri"},"phone":{"type":"string"}},"required":["section","legalName","taxSystem","address"],"additionalProperties":false},{"type":"object","properties":{"section":{"type":"string","const":"portal"},"allowedCfdiUses":{"type":"array","items":{"type":"string","enum":["G01","D06","I07","I06","I01","I05","D09","G02","D04","I04","I03","D08","G03","D03","D02","D01","D05","I02","CN01","I08","CP01","D10","D07","S01"],"description":"Active SAT CFDI-use code.","x-exac-sat-catalog":"cfdi-uses"}},"receiptExpirationDays":{"anyOf":[{"type":"integer","minimum":0,"maximum":365},{"type":"null"}]},"receiptLocationRequired":{"type":"boolean"}},"required":["section"],"additionalProperties":false},{"type":"object","properties":{"section":{"type":"string","const":"globalInvoice"},"enabled":{"type":"boolean"},"periodicity":{"type":"string","enum":["day","week","fortnight","month","two_months"]},"eligibilityStartAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["section"],"additionalProperties":false},{"type":"object","properties":{"section":{"type":"string","const":"automation"},"cfdiSyncEnabled":{"type":"boolean"},"declarationSyncEnabled":{"type":"boolean"}},"required":["section"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"name":{"type":"string"},"timeZone":{"type":"string"},"fiscal":{"type":"object","properties":{"legalName":{"$ref":"#/definitions/__schema0"},"rfc":{"$ref":"#/definitions/__schema0"},"taxSystem":{"$ref":"#/definitions/__schema0"},"rfcPersonType":{"$ref":"#/definitions/__schema0"},"usesBorderRegionStimulus":{"type":"boolean"},"website":{"$ref":"#/definitions/__schema0"},"phone":{"$ref":"#/definitions/__schema0"},"address":{"type":"object","properties":{"street":{"$ref":"#/definitions/__schema0"},"city":{"$ref":"#/definitions/__schema0"},"state":{"$ref":"#/definitions/__schema0"},"exterior":{"$ref":"#/definitions/__schema0"},"interior":{"$ref":"#/definitions/__schema0"},"neighborhood":{"$ref":"#/definitions/__schema0"},"municipality":{"$ref":"#/definitions/__schema0"},"postalCode":{"type":"string"}},"required":["postalCode"],"additionalProperties":false}},"additionalProperties":false},"readiness":{"type":"object","properties":{"production":{"type":"boolean"},"csd":{"type":"boolean"},"fiel":{"type":"boolean"}},"required":["production","csd","fiel"],"additionalProperties":false},"certificates":{"type":"object","properties":{"csd":{"type":"object","properties":{"configured":{"type":"boolean"},"expiresAt":{"$ref":"#/definitions/__schema0"},"serialNumber":{"$ref":"#/definitions/__schema0"}},"required":["configured"],"additionalProperties":false},"fiel":{"type":"object","properties":{"configured":{"type":"boolean"},"expiresAt":{"$ref":"#/definitions/__schema0"}},"required":["configured"],"additionalProperties":false}},"required":["csd","fiel"],"additionalProperties":false},"globalInvoice":{"type":"object","properties":{"enabled":{"type":"boolean"},"periodicity":{"$ref":"#/definitions/__schema0"},"eligibilityStartAt":{"allOf":[{"$ref":"#/definitions/__schema1"}]},"lastRunAt":{"allOf":[{"$ref":"#/definitions/__schema1"}]}},"required":["enabled"],"additionalProperties":false},"automation":{"type":"object","properties":{"cfdiSyncEnabled":{"type":"boolean"},"declarationSyncEnabled":{"type":"boolean"}},"required":["cfdiSyncEnabled","declarationSyncEnabled"],"additionalProperties":false},"portal":{"type":"object","properties":{"allowedCfdiUses":{"type":"array","items":{"type":"string"}},"receiptExpirationDays":{"type":"number"},"receiptLocationRequired":{"type":"boolean"}},"required":["receiptLocationRequired"],"additionalProperties":false}},"required":["name","timeZone","fiscal","readiness","certificates","globalInvoice","automation","portal"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string"},"__schema1":{"type":"string","format":"date-time"}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"workspace","order":20,"permissions":{"kind":"any-of","permissions":["org:update","settings:update"]}}},{"name":"search_documents","description":"Search one public document family at a time. Use cfdi for income, credit-note, transfer, payroll, and payment-complement documents; use withholding, sales_receipt, quote, expense, declaration, tax_compliance_opinion, or sales_receipt_refund for the other families.","inputSchema":{"type":"object","properties":{"input":{"oneOf":[{"type":"object","properties":{"category":{"type":"string","const":"cfdi"},"kind":{"type":"string","enum":["income","credit_note","transfer","payment_complement","payroll"]},"direction":{"type":"string","enum":["issued","received"]},"status":{"type":"string","enum":["draft","valid","canceled"]},"paymentTiming":{"type":"string","enum":["single_payment","deferred_or_installments"]},"outstanding":{"type":"boolean","const":true},"dateFrom":{"$ref":"#/definitions/__schema0"},"dateTo":{"$ref":"#/definitions/__schema1"},"query":{"$ref":"#/definitions/__schema2"},"cursor":{"$ref":"#/definitions/__schema3"},"limit":{"$ref":"#/definitions/__schema4"}},"required":["category"],"additionalProperties":false},{"type":"object","properties":{"category":{"type":"string","const":"withholding"},"direction":{"type":"string","enum":["issued","received"]},"status":{"type":"string","enum":["draft","valid","canceled"]},"dateFrom":{"$ref":"#/definitions/__schema0"},"dateTo":{"$ref":"#/definitions/__schema1"},"query":{"$ref":"#/definitions/__schema2"},"cursor":{"$ref":"#/definitions/__schema3"},"limit":{"$ref":"#/definitions/__schema4"}},"required":["category"],"additionalProperties":false},{"type":"object","properties":{"category":{"type":"string","const":"sales_receipt"},"status":{"type":"string","enum":["open","invoiced","global_invoiced","canceled"]},"dateFrom":{"$ref":"#/definitions/__schema0"},"dateTo":{"$ref":"#/definitions/__schema1"},"query":{"$ref":"#/definitions/__schema2"},"cursor":{"$ref":"#/definitions/__schema3"},"limit":{"$ref":"#/definitions/__schema4"}},"required":["category"],"additionalProperties":false},{"type":"object","properties":{"category":{"type":"string","const":"quote"},"query":{"type":"string","minLength":1},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":50}},"required":["category"],"additionalProperties":false},{"type":"object","properties":{"category":{"type":"string","const":"expense"},"settlementMode":{"type":"string","enum":["credit","paid"]},"dateFrom":{"$ref":"#/definitions/__schema0"},"dateTo":{"$ref":"#/definitions/__schema1"},"query":{"$ref":"#/definitions/__schema2"},"cursor":{"$ref":"#/definitions/__schema3"},"limit":{"$ref":"#/definitions/__schema4"}},"required":["category"],"additionalProperties":false},{"type":"object","properties":{"category":{"type":"string","const":"declaration"},"fiscalYear":{"type":"integer","minimum":2000,"maximum":2100},"query":{"type":"string","minLength":1},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":50}},"required":["category","fiscalYear"],"additionalProperties":false},{"type":"object","properties":{"category":{"type":"string","const":"tax_compliance_opinion"},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":50}},"required":["category"],"additionalProperties":false},{"type":"object","properties":{"category":{"type":"string","const":"sales_receipt_refund"},"status":{"type":"string","enum":["pending","processing","completed","failed","recovery_required","canceled"]},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":50}},"required":["category"],"additionalProperties":false}]}},"required":["input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"__schema1":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"__schema2":{"type":"string","minLength":1},"__schema3":{"type":"string"},"__schema4":{"type":"integer","minimum":1,"maximum":50}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"data":{"type":"object","properties":{"documents":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"documentRef":{"$ref":"#/definitions/__schema0"},"counterpartyName":{"$ref":"#/definitions/__schema1"},"total":{"$ref":"#/definitions/__schema2"},"category":{"type":"string","const":"cfdi"},"direction":{"type":"string","enum":["issued","received"]},"status":{"type":"string","enum":["draft","valid","canceled"]},"archived":{"type":"boolean"},"uuid":{"type":"string"},"issuedLocalDateTime":{"allOf":[{"$ref":"#/definitions/__schema3"}]},"kind":{"type":"string","enum":["income","credit_note","transfer","payment_complement","payroll"]},"cfdiType":{"type":"string","enum":["I","E","T","N","P"]},"employeeId":{"type":"string"}},"required":["documentRef","category","direction","status","archived","kind","cfdiType"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"$ref":"#/definitions/__schema0"},"counterpartyName":{"$ref":"#/definitions/__schema1"},"total":{"$ref":"#/definitions/__schema2"},"category":{"type":"string","const":"withholding"},"direction":{"type":"string","enum":["issued","received"]},"status":{"type":"string","enum":["draft","valid","canceled"]},"archived":{"type":"boolean"},"uuid":{"type":"string"},"issuedLocalDateTime":{"allOf":[{"$ref":"#/definitions/__schema3"}]}},"required":["documentRef","category","direction","status","archived"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"$ref":"#/definitions/__schema0"},"counterpartyName":{"$ref":"#/definitions/__schema1"},"total":{"$ref":"#/definitions/__schema2"},"category":{"type":"string","const":"sales_receipt"},"status":{"type":"string","enum":["open","invoiced","global_invoiced","canceled"]},"businessDate":{"$ref":"#/definitions/__schema4"},"createdAt":{"$ref":"#/definitions/__schema5"}},"required":["documentRef","category","status","businessDate","createdAt"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"$ref":"#/definitions/__schema0"},"counterpartyName":{"$ref":"#/definitions/__schema1"},"total":{"$ref":"#/definitions/__schema2"},"category":{"type":"string","const":"quote"},"status":{"type":"string","enum":["draft","sent","accepted","converted","expired","canceled"]},"issueDate":{"$ref":"#/definitions/__schema4"},"validUntil":{"$ref":"#/definitions/__schema4"}},"required":["documentRef","category","status","issueDate","validUntil"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"$ref":"#/definitions/__schema0"},"counterpartyName":{"$ref":"#/definitions/__schema1"},"total":{"$ref":"#/definitions/__schema2"},"category":{"type":"string","const":"expense"},"businessDate":{"$ref":"#/definitions/__schema4"},"occurredAt":{"$ref":"#/definitions/__schema5"},"settlementMode":{"type":"string","enum":["credit","paid"]}},"required":["documentRef","category","businessDate","occurredAt","settlementMode"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"$ref":"#/definitions/__schema0"},"counterpartyName":{"$ref":"#/definitions/__schema1"},"total":{"$ref":"#/definitions/__schema2"},"category":{"type":"string","const":"declaration"},"fiscalYear":{"type":"number"},"period":{"type":"number"},"filedAt":{"$ref":"#/definitions/__schema4"},"status":{"type":"string"}},"required":["documentRef","category","fiscalYear","period","filedAt"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"$ref":"#/definitions/__schema0"},"counterpartyName":{"$ref":"#/definitions/__schema1"},"total":{"$ref":"#/definitions/__schema2"},"category":{"type":"string","const":"tax_compliance_opinion"},"status":{"type":"string","enum":["positive","negative","unknown"]},"issuedLocalDateTime":{"$ref":"#/definitions/__schema3"},"retrievedAt":{"$ref":"#/definitions/__schema5"}},"required":["documentRef","category","status","issuedLocalDateTime","retrievedAt"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"$ref":"#/definitions/__schema0"},"counterpartyName":{"$ref":"#/definitions/__schema1"},"total":{"$ref":"#/definitions/__schema2"},"category":{"type":"string","const":"sales_receipt_refund"},"status":{"type":"string","enum":["pending","processing","completed","failed","recovery_required","canceled"]},"businessDate":{"allOf":[{"$ref":"#/definitions/__schema4"}]},"createdAt":{"$ref":"#/definitions/__schema5"}},"required":["documentRef","category","status","createdAt"],"additionalProperties":false}]}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["documents","nextCursor","hasMore"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"additionalProperties":false,"definitions":{"__schema0":{"type":"string","pattern":"^(cfdi|withholding|sales_receipt|quote|expense|declaration|tax_compliance_opinion|sales_receipt_refund):.+$"},"__schema1":{"type":"string"},"__schema2":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"],"additionalProperties":false},"__schema3":{"type":"string","pattern":"^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})(?:\\.(\\d{1,9}))?$"},"__schema4":{"type":"string","format":"date"},"__schema5":{"type":"string","format":"date-time"}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"liveOutputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documents":{"type":"array","items":{"type":"object","properties":{"documentRef":{"type":"string"},"category":{"type":"string","enum":["cfdi","withholding","sales_receipt","quote","expense","declaration","tax_compliance_opinion","sales_receipt_refund"]},"status":{"type":"string"},"direction":{"type":"string","enum":["issued","received"]},"counterpartyName":{"type":"string"},"total":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"],"additionalProperties":false}},"required":["documentRef","category"],"additionalProperties":true}},"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"}},"required":["documents","nextCursor","hasMore"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"documents","order":10,"permissions":{"kind":"any-of","permissions":["invoices:read","employees:read","receipts:read","receipts:read:all","quotes:read","expenses:read","sat:read"]}}},{"name":"get_document","description":"Retrieve one document by its public documentRef. Sales receipt details include stable lineRef values and remaining refundable amounts for sales receipt refunds.","inputSchema":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^(?:cfdi|withholding|sales_receipt|quote|expense|declaration|tax_compliance_opinion|sales_receipt_refund):.+$","description":"DocumentRef returned by search_documents"}},"required":["documentRef"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"data":{"anyOf":[{"anyOf":[{"type":"object","properties":{"direction":{"$ref":"#/definitions/__schema0"},"status":{"$ref":"#/definitions/__schema1"},"archived":{"$ref":"#/definitions/__schema2"},"uuid":{"$ref":"#/definitions/__schema3"},"counterpartyName":{"$ref":"#/definitions/__schema4"},"total":{"$ref":"#/definitions/__schema5"},"settlementTerms":{"$ref":"#/definitions/__schema6"},"receivablePlanId":{"$ref":"#/definitions/__schema8"},"documentRef":{"$ref":"#/definitions/__schema9"},"category":{"$ref":"#/definitions/__schema10"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema11"},"inventoryImpact":{"$ref":"#/definitions/__schema13"},"customerId":{"$ref":"#/definitions/__schema15"},"series":{"$ref":"#/definitions/__schema16"},"folio":{"$ref":"#/definitions/__schema17"},"fiscal":{"$ref":"#/definitions/__schema18"},"relatedDocuments":{"$ref":"#/definitions/__schema20"},"kind":{"$ref":"#/definitions/__schema21"},"cfdiType":{"$ref":"#/definitions/__schema22"},"issuer":{"$ref":"#/definitions/__schema23"},"receiver":{"$ref":"#/definitions/__schema23"},"items":{"$ref":"#/definitions/__schema24"},"payment":{"$ref":"#/definitions/__schema25"},"detail":{"$ref":"#/definitions/__schema27"}},"required":["direction","status","archived","total","documentRef","category","kind","cfdiType","issuer","receiver","items","payment","detail"],"additionalProperties":false},{"type":"object","properties":{"direction":{"$ref":"#/definitions/__schema0"},"status":{"$ref":"#/definitions/__schema1"},"archived":{"$ref":"#/definitions/__schema2"},"uuid":{"$ref":"#/definitions/__schema3"},"counterpartyName":{"$ref":"#/definitions/__schema4"},"total":{"$ref":"#/definitions/__schema5"},"settlementTerms":{"$ref":"#/definitions/__schema6"},"receivablePlanId":{"$ref":"#/definitions/__schema8"},"documentRef":{"$ref":"#/definitions/__schema9"},"category":{"$ref":"#/definitions/__schema10"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema11"},"inventoryImpact":{"$ref":"#/definitions/__schema13"},"customerId":{"$ref":"#/definitions/__schema15"},"series":{"$ref":"#/definitions/__schema16"},"folio":{"$ref":"#/definitions/__schema17"},"fiscal":{"$ref":"#/definitions/__schema18"},"relatedDocuments":{"$ref":"#/definitions/__schema20"},"kind":{"$ref":"#/definitions/__schema21"},"cfdiType":{"$ref":"#/definitions/__schema22"},"issuer":{"allOf":[{"$ref":"#/definitions/__schema23"}]},"receiver":{"allOf":[{"$ref":"#/definitions/__schema23"}]},"items":{"allOf":[{"$ref":"#/definitions/__schema24"}]},"payment":{"allOf":[{"$ref":"#/definitions/__schema25"}]},"detail":{"$ref":"#/definitions/__schema28"}},"required":["direction","status","archived","total","documentRef","category","kind","cfdiType","detail"],"additionalProperties":false}]},{"anyOf":[{"type":"object","properties":{"direction":{"$ref":"#/definitions/__schema0"},"status":{"$ref":"#/definitions/__schema1"},"archived":{"$ref":"#/definitions/__schema2"},"uuid":{"$ref":"#/definitions/__schema3"},"counterpartyName":{"$ref":"#/definitions/__schema4"},"total":{"$ref":"#/definitions/__schema5"},"settlementTerms":{"$ref":"#/definitions/__schema6"},"receivablePlanId":{"$ref":"#/definitions/__schema8"},"documentRef":{"$ref":"#/definitions/__schema9"},"category":{"$ref":"#/definitions/__schema10"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema11"},"inventoryImpact":{"$ref":"#/definitions/__schema13"},"customerId":{"$ref":"#/definitions/__schema15"},"series":{"$ref":"#/definitions/__schema16"},"folio":{"$ref":"#/definitions/__schema17"},"fiscal":{"$ref":"#/definitions/__schema18"},"relatedDocuments":{"type":"array","items":{"type":"object","properties":{"relationshipType":{"type":"string"},"uuids":{"type":"array","items":{"type":"string"}}},"required":["relationshipType","uuids"],"additionalProperties":false}},"kind":{"$ref":"#/definitions/__schema30"},"cfdiType":{"$ref":"#/definitions/__schema31"},"issuer":{"$ref":"#/definitions/__schema23"},"receiver":{"$ref":"#/definitions/__schema23"},"items":{"$ref":"#/definitions/__schema24"},"payment":{"allOf":[{"$ref":"#/definitions/__schema25"}]},"detail":{"$ref":"#/definitions/__schema27"}},"required":["direction","status","archived","total","documentRef","category","relatedDocuments","kind","cfdiType","issuer","receiver","items","detail"],"additionalProperties":false},{"type":"object","properties":{"direction":{"$ref":"#/definitions/__schema0"},"status":{"$ref":"#/definitions/__schema1"},"archived":{"$ref":"#/definitions/__schema2"},"uuid":{"$ref":"#/definitions/__schema3"},"counterpartyName":{"$ref":"#/definitions/__schema4"},"total":{"$ref":"#/definitions/__schema5"},"settlementTerms":{"$ref":"#/definitions/__schema6"},"receivablePlanId":{"$ref":"#/definitions/__schema8"},"documentRef":{"$ref":"#/definitions/__schema9"},"category":{"$ref":"#/definitions/__schema10"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema11"},"inventoryImpact":{"$ref":"#/definitions/__schema13"},"customerId":{"$ref":"#/definitions/__schema15"},"series":{"$ref":"#/definitions/__schema16"},"folio":{"$ref":"#/definitions/__schema17"},"fiscal":{"$ref":"#/definitions/__schema18"},"relatedDocuments":{"type":"array","items":{"type":"object","properties":{"relationshipType":{"type":"string"},"uuids":{"type":"array","items":{"type":"string"}}},"required":["relationshipType","uuids"],"additionalProperties":false}},"kind":{"$ref":"#/definitions/__schema30"},"cfdiType":{"$ref":"#/definitions/__schema31"},"issuer":{"allOf":[{"$ref":"#/definitions/__schema23"}]},"receiver":{"allOf":[{"$ref":"#/definitions/__schema23"}]},"items":{"allOf":[{"$ref":"#/definitions/__schema24"}]},"payment":{"allOf":[{"$ref":"#/definitions/__schema25"}]},"detail":{"$ref":"#/definitions/__schema28"}},"required":["direction","status","archived","total","documentRef","category","kind","cfdiType","detail"],"additionalProperties":false}]},{"anyOf":[{"type":"object","properties":{"direction":{"$ref":"#/definitions/__schema0"},"status":{"$ref":"#/definitions/__schema1"},"archived":{"$ref":"#/definitions/__schema2"},"uuid":{"$ref":"#/definitions/__schema3"},"counterpartyName":{"$ref":"#/definitions/__schema4"},"total":{"$ref":"#/definitions/__schema5"},"settlementTerms":{"$ref":"#/definitions/__schema6"},"receivablePlanId":{"$ref":"#/definitions/__schema8"},"documentRef":{"$ref":"#/definitions/__schema9"},"category":{"$ref":"#/definitions/__schema10"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema11"},"inventoryImpact":{"$ref":"#/definitions/__schema13"},"customerId":{"$ref":"#/definitions/__schema15"},"series":{"$ref":"#/definitions/__schema16"},"folio":{"$ref":"#/definitions/__schema17"},"fiscal":{"$ref":"#/definitions/__schema18"},"relatedDocuments":{"$ref":"#/definitions/__schema20"},"kind":{"$ref":"#/definitions/__schema32"},"cfdiType":{"$ref":"#/definitions/__schema33"},"issuer":{"$ref":"#/definitions/__schema23"},"receiver":{"$ref":"#/definitions/__schema23"},"items":{"$ref":"#/definitions/__schema24"},"detail":{"$ref":"#/definitions/__schema27"}},"required":["direction","status","archived","total","documentRef","category","kind","cfdiType","issuer","receiver","items","detail"],"additionalProperties":false},{"type":"object","properties":{"direction":{"$ref":"#/definitions/__schema0"},"status":{"$ref":"#/definitions/__schema1"},"archived":{"$ref":"#/definitions/__schema2"},"uuid":{"$ref":"#/definitions/__schema3"},"counterpartyName":{"$ref":"#/definitions/__schema4"},"total":{"$ref":"#/definitions/__schema5"},"settlementTerms":{"$ref":"#/definitions/__schema6"},"receivablePlanId":{"$ref":"#/definitions/__schema8"},"documentRef":{"$ref":"#/definitions/__schema9"},"category":{"$ref":"#/definitions/__schema10"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema11"},"inventoryImpact":{"$ref":"#/definitions/__schema13"},"customerId":{"$ref":"#/definitions/__schema15"},"series":{"$ref":"#/definitions/__schema16"},"folio":{"$ref":"#/definitions/__schema17"},"fiscal":{"$ref":"#/definitions/__schema18"},"relatedDocuments":{"$ref":"#/definitions/__schema20"},"kind":{"$ref":"#/definitions/__schema32"},"cfdiType":{"$ref":"#/definitions/__schema33"},"issuer":{"allOf":[{"$ref":"#/definitions/__schema23"}]},"receiver":{"allOf":[{"$ref":"#/definitions/__schema23"}]},"items":{"allOf":[{"$ref":"#/definitions/__schema24"}]},"detail":{"$ref":"#/definitions/__schema28"}},"required":["direction","status","archived","total","documentRef","category","kind","cfdiType","detail"],"additionalProperties":false}]},{"anyOf":[{"type":"object","properties":{"direction":{"$ref":"#/definitions/__schema0"},"status":{"$ref":"#/definitions/__schema1"},"archived":{"$ref":"#/definitions/__schema2"},"uuid":{"$ref":"#/definitions/__schema3"},"counterpartyName":{"$ref":"#/definitions/__schema4"},"total":{"$ref":"#/definitions/__schema5"},"settlementTerms":{"$ref":"#/definitions/__schema6"},"receivablePlanId":{"$ref":"#/definitions/__schema8"},"documentRef":{"$ref":"#/definitions/__schema9"},"category":{"$ref":"#/definitions/__schema10"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema11"},"inventoryImpact":{"$ref":"#/definitions/__schema13"},"customerId":{"$ref":"#/definitions/__schema15"},"series":{"$ref":"#/definitions/__schema16"},"folio":{"$ref":"#/definitions/__schema17"},"fiscal":{"$ref":"#/definitions/__schema18"},"relatedDocuments":{"$ref":"#/definitions/__schema20"},"items":{"$ref":"#/definitions/__schema34"},"kind":{"$ref":"#/definitions/__schema35"},"cfdiType":{"$ref":"#/definitions/__schema36"},"issuer":{"$ref":"#/definitions/__schema23"},"receiver":{"$ref":"#/definitions/__schema23"},"paymentComplement":{"$ref":"#/definitions/__schema37"},"detail":{"$ref":"#/definitions/__schema27"}},"required":["direction","status","archived","total","documentRef","category","kind","cfdiType","issuer","receiver","paymentComplement","detail"],"additionalProperties":false},{"type":"object","properties":{"direction":{"$ref":"#/definitions/__schema0"},"status":{"$ref":"#/definitions/__schema1"},"archived":{"$ref":"#/definitions/__schema2"},"uuid":{"$ref":"#/definitions/__schema3"},"counterpartyName":{"$ref":"#/definitions/__schema4"},"total":{"$ref":"#/definitions/__schema5"},"settlementTerms":{"$ref":"#/definitions/__schema6"},"receivablePlanId":{"$ref":"#/definitions/__schema8"},"documentRef":{"$ref":"#/definitions/__schema9"},"category":{"$ref":"#/definitions/__schema10"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema11"},"inventoryImpact":{"$ref":"#/definitions/__schema13"},"customerId":{"$ref":"#/definitions/__schema15"},"series":{"$ref":"#/definitions/__schema16"},"folio":{"$ref":"#/definitions/__schema17"},"fiscal":{"$ref":"#/definitions/__schema18"},"relatedDocuments":{"$ref":"#/definitions/__schema20"},"items":{"$ref":"#/definitions/__schema34"},"kind":{"$ref":"#/definitions/__schema35"},"cfdiType":{"$ref":"#/definitions/__schema36"},"issuer":{"allOf":[{"$ref":"#/definitions/__schema23"}]},"receiver":{"allOf":[{"$ref":"#/definitions/__schema23"}]},"paymentComplement":{"allOf":[{"$ref":"#/definitions/__schema37"}]},"detail":{"$ref":"#/definitions/__schema28"}},"required":["direction","status","archived","total","documentRef","category","kind","cfdiType","detail"],"additionalProperties":false}]},{"anyOf":[{"type":"object","properties":{"direction":{"$ref":"#/definitions/__schema0"},"status":{"$ref":"#/definitions/__schema1"},"archived":{"$ref":"#/definitions/__schema2"},"uuid":{"$ref":"#/definitions/__schema3"},"counterpartyName":{"$ref":"#/definitions/__schema4"},"total":{"$ref":"#/definitions/__schema5"},"settlementTerms":{"$ref":"#/definitions/__schema6"},"receivablePlanId":{"$ref":"#/definitions/__schema8"},"documentRef":{"$ref":"#/definitions/__schema9"},"category":{"$ref":"#/definitions/__schema10"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema11"},"inventoryImpact":{"$ref":"#/definitions/__schema13"},"customerId":{"$ref":"#/definitions/__schema15"},"series":{"$ref":"#/definitions/__schema16"},"folio":{"$ref":"#/definitions/__schema17"},"fiscal":{"$ref":"#/definitions/__schema18"},"relatedDocuments":{"$ref":"#/definitions/__schema20"},"kind":{"$ref":"#/definitions/__schema38"},"cfdiType":{"$ref":"#/definitions/__schema39"},"employeeId":{"$ref":"#/definitions/__schema40"},"issuer":{"$ref":"#/definitions/__schema41"},"receiver":{"$ref":"#/definitions/__schema42"},"payroll":{"$ref":"#/definitions/__schema43"},"detail":{"$ref":"#/definitions/__schema27"}},"required":["direction","status","archived","total","documentRef","category","kind","cfdiType","payroll","detail"],"additionalProperties":false},{"type":"object","properties":{"direction":{"$ref":"#/definitions/__schema0"},"status":{"$ref":"#/definitions/__schema1"},"archived":{"$ref":"#/definitions/__schema2"},"uuid":{"$ref":"#/definitions/__schema3"},"counterpartyName":{"$ref":"#/definitions/__schema4"},"total":{"$ref":"#/definitions/__schema5"},"settlementTerms":{"$ref":"#/definitions/__schema6"},"receivablePlanId":{"$ref":"#/definitions/__schema8"},"documentRef":{"$ref":"#/definitions/__schema9"},"category":{"$ref":"#/definitions/__schema10"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema11"},"inventoryImpact":{"$ref":"#/definitions/__schema13"},"customerId":{"$ref":"#/definitions/__schema15"},"series":{"$ref":"#/definitions/__schema16"},"folio":{"$ref":"#/definitions/__schema17"},"fiscal":{"$ref":"#/definitions/__schema18"},"relatedDocuments":{"$ref":"#/definitions/__schema20"},"kind":{"$ref":"#/definitions/__schema38"},"cfdiType":{"$ref":"#/definitions/__schema39"},"employeeId":{"$ref":"#/definitions/__schema40"},"issuer":{"$ref":"#/definitions/__schema41"},"receiver":{"$ref":"#/definitions/__schema42"},"payroll":{"allOf":[{"$ref":"#/definitions/__schema43"}]},"detail":{"$ref":"#/definitions/__schema28"}},"required":["direction","status","archived","total","documentRef","category","kind","cfdiType","detail"],"additionalProperties":false}]},{"anyOf":[{"type":"object","properties":{"direction":{"$ref":"#/definitions/__schema0"},"status":{"$ref":"#/definitions/__schema1"},"archived":{"$ref":"#/definitions/__schema2"},"uuid":{"$ref":"#/definitions/__schema3"},"counterpartyName":{"$ref":"#/definitions/__schema4"},"total":{"$ref":"#/definitions/__schema5"},"documentRef":{"$ref":"#/definitions/__schema44"},"category":{"$ref":"#/definitions/__schema45"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema46"},"withholding":{"type":"object","properties":{"withholdingTypeCode":{"type":"string"},"description":{"type":"string"},"internalFolio":{"type":"string"},"period":{"type":"object","properties":{"fromMonth":{"type":"number"},"toMonth":{"type":"number"},"year":{"type":"number"}},"required":["fromMonth","toMonth","year"],"additionalProperties":false},"totals":{"type":"object","properties":{"operation":{"type":"number"},"gravable":{"type":"number"},"exempt":{"type":"number"},"retained":{"type":"number"}},"additionalProperties":false},"taxes":{"type":"array","items":{"type":"object","properties":{"tax":{"type":"string"},"amount":{"type":"number"},"paymentType":{"type":"string"}},"required":["tax","amount"],"additionalProperties":false}}},"required":["withholdingTypeCode","period","totals","taxes"],"additionalProperties":false},"detail":{"$ref":"#/definitions/__schema27"}},"required":["direction","status","archived","total","documentRef","category","withholding","detail"],"additionalProperties":false},{"type":"object","properties":{"direction":{"$ref":"#/definitions/__schema0"},"status":{"$ref":"#/definitions/__schema1"},"archived":{"$ref":"#/definitions/__schema2"},"uuid":{"$ref":"#/definitions/__schema3"},"counterpartyName":{"$ref":"#/definitions/__schema4"},"total":{"$ref":"#/definitions/__schema5"},"documentRef":{"$ref":"#/definitions/__schema44"},"category":{"$ref":"#/definitions/__schema45"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema46"},"detail":{"$ref":"#/definitions/__schema28"}},"required":["direction","status","archived","total","documentRef","category","detail"],"additionalProperties":false}]},{"type":"object","properties":{"category":{"type":"string","const":"sales_receipt"},"folio":{"type":"string"},"customerName":{"type":"string"},"locationName":{"type":"string"},"total":{"$ref":"#/definitions/__schema5"},"paymentForm":{"type":"string"},"settlementTerms":{"allOf":[{"$ref":"#/definitions/__schema7"}]},"receivablePlanId":{"type":"string"},"operationalBalance":{"type":"number"},"invoiceRequested":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"lineRef":{"type":"string"},"productId":{"type":"string"},"description":{"type":"string"},"quantity":{"type":"number"},"refundableQuantity":{"type":"number"},"unitPrice":{"type":"number"},"discount":{"type":"number"},"lineTotal":{"type":"number"},"refundableAmount":{"type":"number"}},"required":["lineRef","description","quantity","refundableQuantity","unitPrice","lineTotal","refundableAmount"],"additionalProperties":false}},"documentRef":{"type":"string","pattern":"^sales_receipt:.+$"},"status":{"type":"string","enum":["open","invoiced","global_invoiced","canceled"]},"createdAt":{"$ref":"#/definitions/__schema14"},"businessDate":{"$ref":"#/definitions/__schema26"},"paymentDueDate":{"allOf":[{"$ref":"#/definitions/__schema26"}]},"saleType":{"type":"string","enum":["paid","credit","courtesy"]}},"required":["category","folio","total","invoiceRequested","documentRef","status","createdAt","businessDate","saleType"],"additionalProperties":false},{"type":"object","properties":{"folioNumber":{"type":"number"},"currency":{"type":"string","const":"MXN"},"customerId":{"type":"string"},"customerName":{"type":"string"},"customerEmail":{"type":"string"},"locationId":{"type":"string"},"locationName":{"type":"string"},"notes":{"type":"string"},"settlementTerms":{"allOf":[{"$ref":"#/definitions/__schema7"}]},"receivablePlanId":{"type":"string"},"revisionNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"documentRef":{"type":"string","pattern":"^quote:.+$"},"category":{"type":"string","const":"quote"},"status":{"type":"string","enum":["draft","sent","accepted","converted","expired","canceled"]},"items":{"type":"array","items":{"type":"object","properties":{"lineRef":{"type":"string"},"productId":{"type":"string"},"description":{"type":"string"},"quantity":{"type":"number"},"unitPrice":{"type":"number"},"discount":{"type":"number"},"taxIncluded":{"type":"boolean"},"taxability":{"type":"string","enum":["standard","zero","exempt"]},"taxRate":{"type":"number"},"satProductCode":{"type":"string"},"satUnitCode":{"type":"string"},"unitName":{"type":"string"}},"required":["description","quantity","unitPrice"],"additionalProperties":false}},"totals":{"$ref":"#/definitions/__schema47"},"issueDate":{"$ref":"#/definitions/__schema26"},"validUntil":{"$ref":"#/definitions/__schema26"},"sentAt":{"allOf":[{"$ref":"#/definitions/__schema14"}]},"lastPublishedAt":{"allOf":[{"$ref":"#/definitions/__schema14"}]},"acceptance":{"type":"object","properties":{"acceptedAt":{"$ref":"#/definitions/__schema14"},"invoiceRequested":{"type":"boolean"},"fiscalTreatment":{"type":"string","enum":["public_general","specific_counterparty"]},"fiscalTotals":{"$ref":"#/definitions/__schema47"},"fiscalCustomer":{"type":"object","properties":{"rfc":{"type":"string"},"legalName":{"type":"string"},"taxSystem":{"type":"string"},"postalCode":{"type":"string"},"cfdiUse":{"type":"string"},"email":{"type":"string"}},"required":["rfc","legalName","taxSystem","postalCode","cfdiUse","email"],"additionalProperties":false}},"required":["acceptedAt","invoiceRequested","fiscalTreatment","fiscalTotals"],"additionalProperties":false},"createdAt":{"$ref":"#/definitions/__schema14"},"updatedAt":{"$ref":"#/definitions/__schema14"},"receiptDocumentRef":{"type":"string","pattern":"^sales_receipt:.+$"},"payment":{"type":"object","properties":{"paymentId":{"type":"string"},"source":{"type":"string","enum":["manual","online"]},"amount":{"type":"number"},"currency":{"type":"string","const":"MXN"},"paymentForm":{"type":"string"},"applicationStatus":{"type":"string","enum":["pending","processing","applied","failed","conflict"]},"applicationErrorCode":{"type":"string","enum":["payment_form_required","fiscal_drift","location_resolution_required","duplicate_payment","application_failed"]},"invoiceStatus":{"type":"string","enum":["pending","processing","issued","failed"]},"salesReceiptDocumentRef":{"type":"string","pattern":"^sales_receipt:.+$"},"cfdiDocumentRef":{"type":"string","pattern":"^cfdi:.+$"},"paidAt":{"$ref":"#/definitions/__schema14"}},"required":["paymentId","source","amount","currency","applicationStatus","paidAt"],"additionalProperties":false}},"required":["folioNumber","currency","customerName","documentRef","category","status","items","totals","issueDate","validUntil","createdAt","updatedAt"],"additionalProperties":false},{"type":"object","properties":{"category":{"type":"string","const":"expense"},"description":{"type":"string"},"supplierName":{"type":"string"},"expenseCategory":{"type":"string"},"locationName":{"type":"string"},"settlementMode":{"type":"string","enum":["credit","paid"]},"paymentForm":{"type":"string"},"total":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string","const":"MXN"}},"required":["amount","currency"],"additionalProperties":false},"notes":{"type":"string"},"documentRef":{"type":"string","pattern":"^expense:.+$"},"occurredAt":{"$ref":"#/definitions/__schema14"},"businessDate":{"$ref":"#/definitions/__schema26"}},"required":["category","description","expenseCategory","settlementMode","paymentForm","total","documentRef","occurredAt","businessDate"],"additionalProperties":false},{"type":"object","properties":{"category":{"type":"string","const":"declaration"},"fiscalYear":{"type":"number"},"period":{"type":"number"},"periodicity":{"type":"string"},"declarationType":{"type":"string"},"complementaryType":{"type":"string"},"operationNumber":{"type":"string"},"captureLine":{"type":"string"},"status":{"type":"string"},"total":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string","const":"MXN"}},"required":["amount","currency"],"additionalProperties":false},"paidAmount":{"type":"number"},"documentRef":{"type":"string","pattern":"^declaration:.+$"},"scrapedAt":{"$ref":"#/definitions/__schema14"},"filedAt":{"$ref":"#/definitions/__schema26"},"paymentDate":{"allOf":[{"$ref":"#/definitions/__schema26"}]}},"required":["category","fiscalYear","period","periodicity","declarationType","operationNumber","documentRef","scrapedAt","filedAt"],"additionalProperties":false},{"type":"object","properties":{"category":{"type":"string","const":"tax_compliance_opinion"},"status":{"type":"string","enum":["positive","negative","unknown"]},"pdfAvailable":{"type":"boolean"},"documentRef":{"type":"string","pattern":"^tax_compliance_opinion:.+$"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema12"},"retrievedAt":{"$ref":"#/definitions/__schema14"}},"required":["category","status","pdfAvailable","documentRef","issuedLocalDateTime","retrievedAt"],"additionalProperties":false},{"type":"object","properties":{"reason":{"type":"string","enum":["commercial_refund","resico_reconciliation"]},"settlementMethod":{"type":"string","enum":["cash","transfer","original_method","customer_credit"]},"fiscalTreatment":{"type":"string","enum":["none","credit_note"]},"total":{"$ref":"#/definitions/__schema5"},"note":{"type":"string"},"documentRef":{"type":"string","pattern":"^sales_receipt_refund:.+$"},"category":{"type":"string","const":"sales_receipt_refund"},"receiptDocumentRef":{"type":"string","pattern":"^sales_receipt:.+$"},"status":{"type":"string","enum":["pending","processing","completed","failed","recovery_required","canceled"]},"businessDate":{"allOf":[{"$ref":"#/definitions/__schema26"}]},"createdAt":{"$ref":"#/definitions/__schema14"},"completedAt":{"allOf":[{"$ref":"#/definitions/__schema14"}]}},"required":["reason","settlementMethod","fiscalTreatment","total","documentRef","category","receiptDocumentRef","status","createdAt"],"additionalProperties":false}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"additionalProperties":false,"definitions":{"__schema0":{"type":"string","enum":["issued","received"]},"__schema1":{"type":"string","enum":["draft","valid","canceled"]},"__schema2":{"type":"boolean"},"__schema3":{"type":"string"},"__schema4":{"type":"string"},"__schema5":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"],"additionalProperties":false},"__schema6":{"allOf":[{"$ref":"#/definitions/__schema7"}]},"__schema7":{"type":"object","properties":{"installmentCount":{"type":"integer","minimum":1,"maximum":60},"firstDue":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"transaction_date"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"months_after_transaction"},"months":{"type":"integer","minimum":1,"maximum":60}},"required":["kind","months"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"fixed_date"},"date":{"type":"string"}},"required":["kind","date"],"additionalProperties":false}]},"recurrence":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"anchor_day"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"day_of_month"},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["kind","day"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"last_day"}},"required":["kind"],"additionalProperties":false}]}},"required":["installmentCount","firstDue","recurrence"],"additionalProperties":false},"__schema8":{"type":"string"},"__schema9":{"type":"string","pattern":"^cfdi:.+$"},"__schema10":{"type":"string","const":"cfdi"},"__schema11":{"allOf":[{"$ref":"#/definitions/__schema12"}]},"__schema12":{"type":"string","pattern":"^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})(?:\\.(\\d{1,9}))?$"},"__schema13":{"type":"object","properties":{"locationId":{"type":"string"},"status":{"type":"string","enum":["pending","deducted","reversed"]},"appliedAt":{"allOf":[{"$ref":"#/definitions/__schema14"}]},"reversedAt":{"allOf":[{"$ref":"#/definitions/__schema14"}]}},"required":["status"],"additionalProperties":false},"__schema14":{"type":"string","format":"date-time"},"__schema15":{"type":"string"},"__schema16":{"type":"string"},"__schema17":{"type":"string"},"__schema18":{"type":"object","properties":{"subtotal":{"type":"number"},"ivaTransferred":{"type":"number"},"ivaWithheld":{"type":"number"},"isrWithheld":{"type":"number"},"exchangeRate":{"type":"number"},"totalMxn":{"type":"number"},"placeOfIssue":{"type":"string"},"exportation":{"type":"string"},"taxes":{"type":"object","properties":{"transfers":{"type":"array","items":{"$ref":"#/definitions/__schema19"}},"withholdings":{"type":"array","items":{"$ref":"#/definitions/__schema19"}}},"required":["transfers","withholdings"],"additionalProperties":false},"globalInformation":{"type":"object","properties":{"frequency":{"type":"string"},"months":{"type":"string"},"year":{"type":"number"}},"required":["frequency","months","year"],"additionalProperties":false},"cfdiUse":{"type":"string"},"stampedLocalDateTime":{"allOf":[{"$ref":"#/definitions/__schema12"}]}},"additionalProperties":false},"__schema19":{"type":"object","properties":{"tax":{"type":"string"},"factorType":{"type":"string"},"rateOrFee":{"type":"string"},"amount":{"type":"string"},"base":{"type":"string"}},"required":["tax","factorType"],"additionalProperties":false},"__schema20":{"type":"array","items":{"type":"object","properties":{"relationshipType":{"type":"string"},"uuids":{"type":"array","items":{"type":"string"}}},"required":["relationshipType","uuids"],"additionalProperties":false}},"__schema21":{"type":"string","const":"income"},"__schema22":{"type":"string","const":"I"},"__schema23":{"type":"object","properties":{"rfc":{"type":"string"},"legalName":{"type":"string"},"taxSystem":{"type":"string"},"postalCode":{"type":"string"},"cfdiUse":{"type":"string"}},"required":["rfc","legalName","taxSystem"],"additionalProperties":false},"__schema24":{"type":"array","items":{"type":"object","properties":{"productId":{"type":"string"},"description":{"type":"string"},"quantity":{"type":"number"},"unitPrice":{"type":"number"},"discount":{"type":"number"},"unitName":{"type":"string"},"taxObject":{"type":"string"},"taxes":{"type":"object","properties":{"transfers":{"type":"array","items":{"$ref":"#/definitions/__schema19"}},"withholdings":{"type":"array","items":{"$ref":"#/definitions/__schema19"}}},"required":["transfers","withholdings"],"additionalProperties":false},"satProductCode":{"type":"string"},"satUnitCode":{"type":"string"}},"required":["description","quantity","unitPrice"],"additionalProperties":false}},"__schema25":{"type":"object","properties":{"timing":{"type":"string","enum":["single_payment","deferred_or_installments"]},"formCode":{"type":"string"},"methodCode":{"type":"string"},"dueDate":{"allOf":[{"$ref":"#/definitions/__schema26"}]},"remainingBalance":{"type":"number"},"effectiveRemainingBalance":{"type":"number"},"manualAdjustmentNeedsReview":{"type":"boolean"},"conditions":{"type":"string"}},"required":["timing"],"additionalProperties":false},"__schema26":{"type":"string","format":"date"},"__schema27":{"type":"object","properties":{"availability":{"type":"string","const":"complete"}},"required":["availability"],"additionalProperties":false},"__schema28":{"type":"object","properties":{"availability":{"type":"string","const":"partial"},"missing":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema29"}}},"required":["availability","missing"],"additionalProperties":false},"__schema29":{"type":"string","minLength":1},"__schema30":{"type":"string","const":"credit_note"},"__schema31":{"type":"string","const":"E"},"__schema32":{"type":"string","const":"transfer"},"__schema33":{"type":"string","const":"T"},"__schema34":{"allOf":[{"$ref":"#/definitions/__schema24"}]},"__schema35":{"type":"string","const":"payment_complement"},"__schema36":{"type":"string","const":"P"},"__schema37":{"type":"object","properties":{"version":{"type":"string"},"totalPayments":{"type":"number"},"payments":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"amount":{"type":"number"},"exchangeRate":{"type":"number"},"relatedCfdis":{"type":"array","items":{"type":"object","properties":{"uuid":{"type":"string"},"series":{"type":"string"},"folio":{"type":"string"},"currency":{"type":"string"},"taxObject":{"type":"string"},"installment":{"type":"string"},"balances":{"type":"object","properties":{"previous":{"type":"number"},"paid":{"type":"number"},"remaining":{"type":"number"}},"additionalProperties":false},"taxes":{"type":"object","properties":{"transfers":{"type":"array","items":{"$ref":"#/definitions/__schema19"}},"withholdings":{"type":"array","items":{"$ref":"#/definitions/__schema19"}}},"required":["transfers","withholdings"],"additionalProperties":false}},"required":["uuid","currency"],"additionalProperties":false}},"formCode":{"type":"string"},"paidLocalDateTime":{"$ref":"#/definitions/__schema12"}},"required":["currency","amount","relatedCfdis","formCode","paidLocalDateTime"],"additionalProperties":false}}},"required":["version","totalPayments","payments"],"additionalProperties":false},"__schema38":{"type":"string","const":"payroll"},"__schema39":{"type":"string","const":"N"},"__schema40":{"type":"string"},"__schema41":{"allOf":[{"$ref":"#/definitions/__schema23"}]},"__schema42":{"allOf":[{"$ref":"#/definitions/__schema23"}]},"__schema43":{"type":"object","properties":{"paidDays":{"type":"number"},"earnings":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"taxableAmount":{"type":"number"},"exemptAmount":{"type":"number"}},"additionalProperties":false}},"deductions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"amount":{"type":"number"}},"additionalProperties":false}},"otherPayments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"amount":{"type":"number"},"employmentSubsidy":{"type":"number"}},"additionalProperties":false}},"totals":{"type":"object","properties":{"earnings":{"type":"number"},"deductions":{"type":"number"},"otherPayments":{"type":"number"},"net":{"type":"number"}},"additionalProperties":false},"employee":{"type":"object","properties":{"curp":{"type":"string"},"employeeNumber":{"type":"string"},"socialSecurityNumber":{"type":"string"},"contractType":{"type":"string"},"regimeType":{"type":"string"},"paymentFrequency":{"type":"string"},"stateCode":{"type":"string"},"positionRisk":{"type":"string"},"integratedDailySalary":{"type":"number"},"employmentStartedOn":{"allOf":[{"$ref":"#/definitions/__schema26"}]}},"additionalProperties":false},"period":{"type":"object","properties":{"paidOn":{"$ref":"#/definitions/__schema26"},"startedOn":{"allOf":[{"$ref":"#/definitions/__schema26"}]},"endedOn":{"allOf":[{"$ref":"#/definitions/__schema26"}]}},"required":["paidOn"],"additionalProperties":false}},"required":["earnings","deductions","otherPayments","totals","employee","period"],"additionalProperties":false},"__schema44":{"type":"string","pattern":"^withholding:.+$"},"__schema45":{"type":"string","const":"withholding"},"__schema46":{"allOf":[{"$ref":"#/definitions/__schema12"}]},"__schema47":{"type":"object","properties":{"subtotal":{"type":"number"},"discount":{"type":"number"},"taxes":{"type":"number"},"total":{"type":"number"},"taxBreakdown":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["IVA","ISR"]},"factor":{"type":"string","enum":["Tasa","Exento"]},"rate":{"type":"number"},"withholding":{"type":"boolean"},"base":{"type":"number"},"amount":{"type":"number"},"label":{"type":"string"}},"required":["type","factor","rate","withholding","base","amount","label"],"additionalProperties":false}}},"required":["subtotal","taxes","total","taxBreakdown"],"additionalProperties":false}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"liveOutputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string"},"category":{"type":"string","enum":["cfdi","withholding","sales_receipt","quote","expense","declaration","tax_compliance_opinion","sales_receipt_refund"]},"status":{"type":"string"},"direction":{"type":"string","enum":["issued","received"]},"counterpartyName":{"type":"string"},"total":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"],"additionalProperties":false}},"required":["documentRef","category"],"additionalProperties":true},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"documents","order":20,"permissions":{"kind":"any-of","permissions":["invoices:read","employees:read","receipts:read","receipts:read:all","quotes:read","expenses:read","sat:read"]}}},{"name":"send_document","description":"Send a document to a recipient. CFDI documents support the document or cancellation_receipt attachment set; sales receipts and quotes support document only.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"anyOf":[{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^(cfdi|withholding):.+$","description":"Fiscal documentRef returned by search_documents"},"content":{"description":"Attachment set to send; defaults to document","allOf":[{"$ref":"#/definitions/__schema0"}]},"recipient":{"$ref":"#/definitions/__schema1"}},"required":["documentRef"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^(sales_receipt|quote):.+$","description":"DocumentRef returned by search_documents"},"content":{"type":"string","const":"document"},"recipient":{"$ref":"#/definitions/__schema1"}},"required":["documentRef"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","enum":["document","cancellation_receipt"]},"__schema1":{"description":"Recipient override; defaults to the saved receptor email","allOf":[{"$ref":"#/definitions/__schema2"}]},"__schema2":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string"},"content":{"type":"string","enum":["document","cancellation_receipt"]},"recipient":{"type":"string"},"sent":{"type":"boolean","const":true}},"required":["documentRef","content","recipient","sent"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"documents","order":30,"permissions":{"kind":"any-of","permissions":["invoices:manage","receipts:update","quotes:manage"]}}},{"name":"cancel_fiscal_document","description":"Request SAT cancellation for a stamped CFDI or withholding document. Drafts should be archived instead.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"anyOf":[{"type":"object","properties":{"documentRef":{"$ref":"#/definitions/__schema0"},"reason":{"$ref":"#/definitions/__schema1"},"replacementUuid":{"$ref":"#/definitions/__schema2"},"linkedReceiptBehavior":{"$ref":"#/definitions/__schema4"}},"required":["documentRef","reason"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"$ref":"#/definitions/__schema6"},"reason":{"$ref":"#/definitions/__schema1"},"replacementUuid":{"$ref":"#/definitions/__schema2"},"linkedReceiptBehavior":{"$ref":"#/definitions/__schema4"}},"required":["documentRef","reason"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","pattern":"^cfdi:.+$"},"__schema1":{"type":"string","enum":["01","02","03","04"],"description":"SAT cancellation reason code"},"__schema2":{"description":"Required when reason is 01","allOf":[{"$ref":"#/definitions/__schema3"}]},"__schema3":{"type":"string","minLength":1},"__schema4":{"description":"Required when one or more directly linked receipts exist; applies to all of them","allOf":[{"$ref":"#/definitions/__schema5"}]},"__schema5":{"type":"string","enum":["reopen","cancel"]},"__schema6":{"type":"string","pattern":"^withholding:.+$"}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"pending":{"type":"boolean"},"documentRef":{"type":"string","pattern":"^(cfdi|withholding|sales_receipt|quote|expense|declaration|tax_compliance_opinion|sales_receipt_refund):.+$"},"status":{"type":"string","enum":["draft","valid","canceled"]}},"required":["pending","documentRef","status"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"cfdi","order":80,"permissions":["invoices:manage"]}},{"name":"archive_fiscal_document","description":"Archive or restore a CFDI or withholding document without deleting its fiscal or authoring history.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"anyOf":[{"type":"object","properties":{"archived":{"$ref":"#/definitions/__schema0"},"documentRef":{"type":"string","pattern":"^cfdi:.+$"}},"required":["archived","documentRef"],"additionalProperties":false},{"type":"object","properties":{"archived":{"$ref":"#/definitions/__schema0"},"documentRef":{"type":"string","pattern":"^withholding:.+$"}},"required":["archived","documentRef"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"boolean","description":"true archives a fiscal document; false restores it"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^(cfdi|withholding|sales_receipt|quote|expense|declaration|tax_compliance_opinion|sales_receipt_refund):.+$"},"archived":{"type":"boolean"}},"required":["documentRef","archived"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"cfdi","order":90,"permissions":["invoices:manage"]}},{"name":"get_document_file","description":"Retrieve one document file as an MCP binary resource. Use preview_pdf to render an unstamped CFDI draft before stamping; the preview has no fiscal validity. CFDIs also support pdf, xml, zip, cancellation_pdf, and cancellation_xml; withholdings support pdf, xml, and zip; sales receipts and quotes support pdf; declarations support pdf, payment_pdf, and full_pdf; opinions support pdf.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","anyOf":[{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^cfdi:.+$","description":"CFDI documentRef returned by search_documents"},"file":{"type":"string","enum":["pdf","xml","zip","preview_pdf","cancellation_pdf","cancellation_xml"]}},"required":["documentRef","file"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^withholding:.+$","description":"Withholding documentRef returned by search_documents"},"file":{"type":"string","enum":["pdf","xml","zip"]}},"required":["documentRef","file"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^sales_receipt:.+$"},"file":{"type":"string","const":"pdf"}},"required":["documentRef","file"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^quote:.+$"},"file":{"type":"string","const":"pdf"}},"required":["documentRef","file"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^declaration:.+$"},"file":{"type":"string","enum":["pdf","payment_pdf","full_pdf"]}},"required":["documentRef","file"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^tax_compliance_opinion:.+$"},"file":{"type":"string","const":"pdf"}},"required":["documentRef","file"],"additionalProperties":false}]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"_meta":{"ui":{"resourceUri":"ui://exac/document-preview/v1"},"ui/resourceUri":"ui://exac/document-preview/v1"},"docs":{"group":"documents","order":40,"permissions":{"kind":"any-of","permissions":["invoices:read","receipts:read","quotes:read","sat:read"]}}},{"name":"get_contacts","description":"Search customers/suppliers or retrieve one contact. Choose operation search or get, then choose kind customer or supplier.","inputSchema":{"type":"object","properties":{"input":{"oneOf":[{"type":"object","properties":{"operation":{"type":"string","const":"search"},"kind":{"$ref":"#/definitions/__schema0"},"query":{"description":"Legal name, RFC, code, or email","allOf":[{"$ref":"#/definitions/__schema1"}]},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["operation","kind"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"get"},"kind":{"$ref":"#/definitions/__schema0"},"contactId":{"type":"string"}},"required":["operation","kind","contactId"],"additionalProperties":false}]}},"required":["input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","enum":["customer","supplier"],"description":"customer is a buyer; supplier is a business you pay"},"__schema1":{"type":"string","minLength":1}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"contacts":{"type":"array","items":{"$ref":"#/definitions/__schema0"}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["contacts","nextCursor","hasMore"],"additionalProperties":false},{"$ref":"#/definitions/__schema0"}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"oneOf":[{"type":"object","properties":{"contactId":{"$ref":"#/definitions/__schema1"},"legalName":{"$ref":"#/definitions/__schema2"},"code":{"$ref":"#/definitions/__schema3"},"email":{"$ref":"#/definitions/__schema4"},"rfc":{"$ref":"#/definitions/__schema5"},"taxSystem":{"$ref":"#/definitions/__schema6"},"phone":{"$ref":"#/definitions/__schema7"},"address":{"$ref":"#/definitions/__schema8"},"updatedAt":{"$ref":"#/definitions/__schema9"},"kind":{"type":"string","const":"customer"},"cfdiUse":{"type":"string"},"creditEnabled":{"type":"boolean"},"creditByDefault":{"type":"boolean"},"defaultPaymentTermDays":{"type":"integer","minimum":1,"maximum":365}},"required":["contactId","legalName","updatedAt","kind"],"additionalProperties":false},{"type":"object","properties":{"contactId":{"$ref":"#/definitions/__schema1"},"legalName":{"$ref":"#/definitions/__schema2"},"code":{"$ref":"#/definitions/__schema3"},"email":{"$ref":"#/definitions/__schema4"},"rfc":{"$ref":"#/definitions/__schema5"},"taxSystem":{"$ref":"#/definitions/__schema6"},"phone":{"$ref":"#/definitions/__schema7"},"address":{"$ref":"#/definitions/__schema8"},"updatedAt":{"$ref":"#/definitions/__schema9"},"kind":{"type":"string","const":"supplier"}},"required":["contactId","legalName","updatedAt","kind"],"additionalProperties":false}]},"__schema1":{"type":"string","minLength":1},"__schema2":{"type":"string"},"__schema3":{"type":"string"},"__schema4":{"type":"string"},"__schema5":{"type":"string"},"__schema6":{"type":"string"},"__schema7":{"type":"string"},"__schema8":{"type":"object","properties":{"street":{"type":"string"},"exterior":{"type":"string"},"interior":{"type":"string"},"neighborhood":{"type":"string"},"city":{"type":"string"},"municipality":{"type":"string"},"state":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}},"required":["postalCode","country"],"additionalProperties":false},"__schema9":{"type":"string","format":"date-time"}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"catalog","order":20,"permissions":{"kind":"variant","selector":"input.kind","variants":{"customer":{"kind":"all-of","permissions":["customers:read"]},"supplier":{"kind":"all-of","permissions":["providers:read"]}}}}},{"name":"save_contact","description":"Create or update one customer/supplier. Use get_contacts to obtain contactId for updates. Credit fields apply only to customers.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"anyOf":[{"type":"object","properties":{"operation":{"$ref":"#/definitions/__schema0"},"kind":{"$ref":"#/definitions/__schema1"},"legalName":{"$ref":"#/definitions/__schema2"},"email":{"$ref":"#/definitions/__schema3"},"rfc":{"$ref":"#/definitions/__schema4"},"code":{"$ref":"#/definitions/__schema5"},"taxSystem":{"$ref":"#/definitions/__schema6"},"phone":{"$ref":"#/definitions/__schema7"},"address":{"$ref":"#/definitions/__schema8"},"cfdiUse":{"$ref":"#/definitions/__schema9"},"creditEnabled":{"$ref":"#/definitions/__schema11"},"creditByDefault":{"$ref":"#/definitions/__schema12"},"defaultPaymentTermDays":{"$ref":"#/definitions/__schema13"}},"required":["operation","kind","legalName"],"additionalProperties":false},{"type":"object","properties":{"operation":{"$ref":"#/definitions/__schema15"},"contactId":{"$ref":"#/definitions/__schema16"},"legalName":{"$ref":"#/definitions/__schema17"},"email":{"$ref":"#/definitions/__schema18"},"rfc":{"$ref":"#/definitions/__schema19"},"code":{"$ref":"#/definitions/__schema20"},"taxSystem":{"$ref":"#/definitions/__schema21"},"phone":{"$ref":"#/definitions/__schema22"},"address":{"$ref":"#/definitions/__schema23"},"cfdiUse":{"$ref":"#/definitions/__schema24"},"creditEnabled":{"$ref":"#/definitions/__schema25"},"creditByDefault":{"$ref":"#/definitions/__schema26"},"defaultPaymentTermDays":{"$ref":"#/definitions/__schema27"},"kind":{"$ref":"#/definitions/__schema28"}},"required":["operation","contactId","kind"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"create"},"kind":{"type":"string","const":"supplier"},"legalName":{"$ref":"#/definitions/__schema2"},"email":{"$ref":"#/definitions/__schema3"},"rfc":{"$ref":"#/definitions/__schema4"},"code":{"$ref":"#/definitions/__schema5"},"taxSystem":{"$ref":"#/definitions/__schema6"},"phone":{"$ref":"#/definitions/__schema7"},"address":{"$ref":"#/definitions/__schema8"}},"required":["operation","kind","legalName"],"additionalProperties":false},{"type":"object","properties":{"operation":{"$ref":"#/definitions/__schema29"},"contactId":{"$ref":"#/definitions/__schema30"},"legalName":{"$ref":"#/definitions/__schema31"},"email":{"$ref":"#/definitions/__schema32"},"rfc":{"$ref":"#/definitions/__schema33"},"code":{"$ref":"#/definitions/__schema34"},"taxSystem":{"$ref":"#/definitions/__schema35"},"phone":{"$ref":"#/definitions/__schema36"},"address":{"$ref":"#/definitions/__schema37"},"kind":{"$ref":"#/definitions/__schema38"}},"required":["operation","contactId","kind"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","const":"create"},"__schema1":{"type":"string","const":"customer"},"__schema2":{"type":"string"},"__schema3":{"type":"string"},"__schema4":{"type":"string"},"__schema5":{"type":"string"},"__schema6":{"type":"string","enum":["601","603","605","606","607","608","610","611","612","614","615","616","620","621","622","623","624","625","626"],"description":"Active SAT tax-system code.","x-exac-sat-catalog":"tax-systems"},"__schema7":{"type":"string"},"__schema8":{"type":"object","properties":{"street":{"type":"string"},"exterior":{"type":"string"},"interior":{"type":"string"},"neighborhood":{"type":"string"},"city":{"type":"string"},"municipality":{"type":"string"},"state":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}},"required":["postalCode","country"],"additionalProperties":false},"__schema9":{"allOf":[{"$ref":"#/definitions/__schema10"}]},"__schema10":{"type":"string","enum":["G01","D06","I07","I06","I01","I05","D09","G02","D04","I04","I03","D08","G03","D03","D02","D01","D05","I02","CN01","I08","CP01","D10","D07","S01"],"description":"Active SAT CFDI-use code.","x-exac-sat-catalog":"cfdi-uses"},"__schema11":{"type":"boolean"},"__schema12":{"type":"boolean"},"__schema13":{"allOf":[{"$ref":"#/definitions/__schema14"}]},"__schema14":{"type":"integer","minimum":1,"maximum":365},"__schema15":{"type":"string","const":"update"},"__schema16":{"type":"string"},"__schema17":{"allOf":[{"$ref":"#/definitions/__schema2"}]},"__schema18":{"allOf":[{"$ref":"#/definitions/__schema3"}]},"__schema19":{"allOf":[{"$ref":"#/definitions/__schema4"}]},"__schema20":{"allOf":[{"$ref":"#/definitions/__schema5"}]},"__schema21":{"allOf":[{"$ref":"#/definitions/__schema6"}]},"__schema22":{"allOf":[{"$ref":"#/definitions/__schema7"}]},"__schema23":{"allOf":[{"$ref":"#/definitions/__schema8"}]},"__schema24":{"allOf":[{"$ref":"#/definitions/__schema10"}]},"__schema25":{"type":"boolean"},"__schema26":{"type":"boolean"},"__schema27":{"anyOf":[{"$ref":"#/definitions/__schema14"},{"type":"null"}]},"__schema28":{"type":"string","const":"customer"},"__schema29":{"type":"string","const":"update"},"__schema30":{"type":"string"},"__schema31":{"allOf":[{"$ref":"#/definitions/__schema2"}]},"__schema32":{"allOf":[{"$ref":"#/definitions/__schema3"}]},"__schema33":{"allOf":[{"$ref":"#/definitions/__schema4"}]},"__schema34":{"allOf":[{"$ref":"#/definitions/__schema5"}]},"__schema35":{"allOf":[{"$ref":"#/definitions/__schema6"}]},"__schema36":{"allOf":[{"$ref":"#/definitions/__schema7"}]},"__schema37":{"allOf":[{"$ref":"#/definitions/__schema8"}]},"__schema38":{"type":"string","const":"supplier"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"oneOf":[{"type":"object","properties":{"contactId":{"$ref":"#/definitions/__schema0"},"legalName":{"$ref":"#/definitions/__schema1"},"code":{"$ref":"#/definitions/__schema2"},"email":{"$ref":"#/definitions/__schema3"},"rfc":{"$ref":"#/definitions/__schema4"},"taxSystem":{"$ref":"#/definitions/__schema5"},"phone":{"$ref":"#/definitions/__schema6"},"address":{"$ref":"#/definitions/__schema7"},"updatedAt":{"$ref":"#/definitions/__schema8"},"kind":{"type":"string","const":"customer"},"cfdiUse":{"type":"string"},"creditEnabled":{"type":"boolean"},"creditByDefault":{"type":"boolean"},"defaultPaymentTermDays":{"type":"integer","minimum":1,"maximum":365}},"required":["contactId","legalName","updatedAt","kind"],"additionalProperties":false},{"type":"object","properties":{"contactId":{"$ref":"#/definitions/__schema0"},"legalName":{"$ref":"#/definitions/__schema1"},"code":{"$ref":"#/definitions/__schema2"},"email":{"$ref":"#/definitions/__schema3"},"rfc":{"$ref":"#/definitions/__schema4"},"taxSystem":{"$ref":"#/definitions/__schema5"},"phone":{"$ref":"#/definitions/__schema6"},"address":{"$ref":"#/definitions/__schema7"},"updatedAt":{"$ref":"#/definitions/__schema8"},"kind":{"type":"string","const":"supplier"}},"required":["contactId","legalName","updatedAt","kind"],"additionalProperties":false}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","minLength":1},"__schema1":{"type":"string"},"__schema2":{"type":"string"},"__schema3":{"type":"string"},"__schema4":{"type":"string"},"__schema5":{"type":"string"},"__schema6":{"type":"string"},"__schema7":{"type":"object","properties":{"street":{"type":"string"},"exterior":{"type":"string"},"interior":{"type":"string"},"neighborhood":{"type":"string"},"city":{"type":"string"},"municipality":{"type":"string"},"state":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}},"required":["postalCode","country"],"additionalProperties":false},"__schema8":{"type":"string","format":"date-time"}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"catalog","order":30,"permissions":{"kind":"variant","selector":"input.kind","variants":{"customer":{"kind":"all-of","permissions":["customers:manage"]},"supplier":{"kind":"all-of","permissions":["providers:manage"]}}}}},{"name":"get_products","description":"Search products, retrieve one product, or list its linked suppliers.","inputSchema":{"type":"object","properties":{"input":{"oneOf":[{"type":"object","properties":{"operation":{"type":"string","const":"search"},"query":{"type":"string","minLength":1},"status":{"default":"active","type":"string","enum":["active","inactive","all"]},"stockStatus":{"type":"string","enum":["available","out_of_stock"]},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["operation","status"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"get"},"productId":{"type":"string"}},"required":["operation","productId"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"suppliers"},"productId":{"type":"string"}},"required":["operation","productId"],"additionalProperties":false}]}},"required":["input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"products":{"type":"array","items":{"$ref":"#/definitions/__schema0"}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["products","nextCursor","hasMore"],"additionalProperties":false},{"type":"object","properties":{"suppliers":{"type":"array","items":{"type":"object","properties":{"supplierId":{"type":"string"},"legalName":{"type":"string"},"rfc":{"type":"string"},"email":{"type":"string"}},"required":["supplierId","legalName"],"additionalProperties":false}}},"required":["suppliers"],"additionalProperties":false},{"$ref":"#/definitions/__schema0"}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"object","properties":{"productId":{"type":"string","minLength":1},"description":{"type":"string"},"sku":{"type":"string"},"code":{"type":"string"},"active":{"type":"boolean"},"price":{"type":"number"},"quantityDiscounts":{"maxItems":10,"type":"array","items":{"$ref":"#/definitions/__schema1"}},"taxIncluded":{"type":"boolean"},"taxRate":{"type":"number"},"taxability":{"type":"string"},"taxExemptReason":{"type":"string"},"stock":{"type":"number"},"stockStatus":{"type":"string","enum":["available","out_of_stock"]},"satProductCode":{"type":"string"},"satUnitCode":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"}},"required":["productId","description","active","price","updatedAt"],"additionalProperties":false},"__schema1":{"type":"object","properties":{"minQuantity":{"type":"number"},"percentage":{"type":"number"}},"required":["minQuantity","percentage"],"additionalProperties":false}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"catalog","order":10,"permissions":["products:read"]}},{"name":"get_inventory","description":"Read product inventory levels, product movements, the organization movement register, grouped inventory operations, or the movements within one inventory operation.","inputSchema":{"type":"object","properties":{"input":{"oneOf":[{"type":"object","properties":{"operation":{"type":"string","const":"inventory_levels"},"productId":{"type":"string"},"cursor":{"$ref":"#/definitions/__schema0"},"limit":{"$ref":"#/definitions/__schema1"}},"required":["operation","productId"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"movements"},"view":{"allOf":[{"$ref":"#/definitions/__schema2"}]},"productId":{"type":"string"},"locationId":{"type":"string"},"searchQuery":{"type":"string","minLength":1,"maxLength":120},"dateFrom":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"dateTo":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"cursor":{"$ref":"#/definitions/__schema0"},"limit":{"$ref":"#/definitions/__schema1"}},"required":["operation"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"inventory_operations"},"view":{"allOf":[{"$ref":"#/definitions/__schema2"}]},"productId":{"type":"string"},"locationId":{"type":"string"},"supplierId":{"type":"string"},"sourceType":{"type":"string","enum":["manual","sale","inventory_receipt","import"]},"searchQuery":{"type":"string","minLength":1,"maxLength":120},"dateFrom":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"dateTo":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"cursor":{"$ref":"#/definitions/__schema0"},"limit":{"$ref":"#/definitions/__schema1"}},"required":["operation"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"inventory_operation_movements"},"operationId":{"type":"string"},"cursor":{"$ref":"#/definitions/__schema0"},"limit":{"$ref":"#/definitions/__schema1"}},"required":["operation","operationId"],"additionalProperties":false}]}},"required":["input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string"},"__schema1":{"type":"integer","minimum":1,"maximum":100},"__schema2":{"type":"string","enum":["register","entries","exits","returns"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"levels":{"type":"array","items":{"type":"object","properties":{"inventoryLevelId":{"type":"string"},"productId":{"$ref":"#/definitions/__schema0"},"locationId":{"type":"string"},"locationName":{"type":"string"},"stock":{"type":"number"},"stockStatus":{"type":"string","enum":["available","out_of_stock"]},"updatedAt":{"$ref":"#/definitions/__schema1"}},"required":["inventoryLevelId","productId","locationId","locationName","stock","stockStatus","updatedAt"],"additionalProperties":false}},"nextCursor":{"$ref":"#/definitions/__schema2"},"hasMore":{"$ref":"#/definitions/__schema3"}},"required":["levels","nextCursor","hasMore"],"additionalProperties":false},{"type":"object","properties":{"movements":{"type":"array","items":{"type":"object","properties":{"movementId":{"type":"string"},"productId":{"$ref":"#/definitions/__schema0"},"productCode":{"type":"string"},"productSku":{"type":"string"},"productDescription":{"type":"string"},"productDeleted":{"type":"boolean"},"locationId":{"type":"string"},"locationName":{"type":"string"},"businessDate":{"type":"string"},"businessTimeZone":{"type":"string"},"delta":{"type":"number"},"direction":{"$ref":"#/definitions/__schema4"},"reason":{"$ref":"#/definitions/__schema5"},"resultingStock":{"type":"number"},"resultingStockScope":{"type":"string","enum":["aggregate","location"]},"sourceType":{"$ref":"#/definitions/__schema6"},"sourceLabel":{"type":"string"},"receiptDocumentRef":{"type":"string"},"cfdiDocumentRef":{"type":"string"},"inventoryReceiptId":{"type":"string"},"supplierId":{"type":"string"},"supplierName":{"type":"string"},"note":{"type":"string"},"actorIdentifier":{"type":"string"},"actorName":{"type":"string"},"createdAt":{"$ref":"#/definitions/__schema1"}},"required":["movementId","productId","productDescription","productDeleted","delta","direction","reason","resultingStock","resultingStockScope","sourceType","sourceLabel","createdAt"],"additionalProperties":false}},"nextCursor":{"$ref":"#/definitions/__schema2"},"hasMore":{"$ref":"#/definitions/__schema3"}},"required":["movements","nextCursor","hasMore"],"additionalProperties":false},{"type":"object","properties":{"operations":{"type":"array","items":{"type":"object","properties":{"operationId":{"type":"string"},"businessDate":{"type":"string"},"businessTimeZone":{"type":"string"},"direction":{"$ref":"#/definitions/__schema4"},"reason":{"$ref":"#/definitions/__schema5"},"sourceType":{"$ref":"#/definitions/__schema6"},"sourceLabel":{"type":"string"},"sourceReference":{"type":"string"},"itemCount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"locationId":{"type":"string"},"locationName":{"type":"string"},"supplierId":{"type":"string"},"supplierName":{"type":"string"},"receiptDocumentRef":{"type":"string"},"inventoryReceiptId":{"type":"string"},"note":{"type":"string"},"actorIdentifier":{"type":"string"},"actorName":{"type":"string"},"createdAt":{"$ref":"#/definitions/__schema1"}},"required":["operationId","direction","reason","sourceType","sourceLabel","itemCount","createdAt"],"additionalProperties":false}},"nextCursor":{"$ref":"#/definitions/__schema2"},"hasMore":{"$ref":"#/definitions/__schema3"}},"required":["operations","nextCursor","hasMore"],"additionalProperties":false}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","minLength":1},"__schema1":{"type":"string","format":"date-time"},"__schema2":{"anyOf":[{"type":"string"},{"type":"null"}]},"__schema3":{"type":"boolean"},"__schema4":{"type":"string","enum":["entry","exit","neutral"]},"__schema5":{"type":"string","enum":["initial","sale","sale_reversal","restock","adjustment"]},"__schema6":{"type":"string","enum":["manual","sale","inventory_receipt","import"]}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"catalog","order":20,"permissions":["products:read"]}},{"name":"save_product","description":"Create a product or update an existing product in the organization catalog. operation selects create or update.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"oneOf":[{"type":"object","properties":{"operation":{"type":"string","const":"create"},"description":{"type":"string","minLength":1},"sku":{"type":"string"},"code":{"type":"string"},"price":{"type":"number","exclusiveMinimum":0},"quantityDiscounts":{"allOf":[{"$ref":"#/definitions/__schema0"}]},"taxIncluded":{"$ref":"#/definitions/__schema2"},"taxability":{"$ref":"#/definitions/__schema3"},"taxExemptReason":{"type":"string"},"supplierIds":{"$ref":"#/definitions/__schema4"},"locationIds":{"$ref":"#/definitions/__schema5"},"classificationValueIds":{"$ref":"#/definitions/__schema6"},"satProductCode":{"type":"string"},"satUnitCode":{"type":"string"}},"required":["operation","description","price"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"update"},"productId":{"type":"string"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}]},"code":{"anyOf":[{"type":"string"},{"type":"null"}]},"quantityDiscounts":{"anyOf":[{"$ref":"#/definitions/__schema0"},{"type":"null"}]},"taxIncluded":{"$ref":"#/definitions/__schema2"},"taxability":{"$ref":"#/definitions/__schema3"},"taxExemptReason":{"anyOf":[{"type":"string"},{"type":"null"}]},"supplierIds":{"$ref":"#/definitions/__schema4"},"locationIds":{"$ref":"#/definitions/__schema5"},"classificationValueIds":{"$ref":"#/definitions/__schema6"},"description":{"type":"string","minLength":1},"price":{"type":"number","exclusiveMinimum":0},"active":{"type":"boolean"},"satProductCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"satUnitCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["operation","productId"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"maxItems":10,"type":"array","items":{"$ref":"#/definitions/__schema1"}},"__schema1":{"type":"object","properties":{"minQuantity":{"type":"number"},"percentage":{"type":"number"}},"required":["minQuantity","percentage"],"additionalProperties":false},"__schema2":{"type":"boolean"},"__schema3":{"type":"string","enum":["standard","zero","exempt"]},"__schema4":{"type":"array","items":{"type":"string"}},"__schema5":{"type":"array","items":{"type":"string"}},"__schema6":{"maxItems":20,"type":"array","items":{"$ref":"#/definitions/__schema7"}},"__schema7":{"type":"string"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"productId":{"type":"string","minLength":1},"description":{"type":"string"},"sku":{"type":"string"},"code":{"type":"string"},"active":{"type":"boolean"},"price":{"type":"number"},"quantityDiscounts":{"maxItems":10,"type":"array","items":{"$ref":"#/definitions/__schema0"}},"taxIncluded":{"type":"boolean"},"taxRate":{"type":"number"},"taxability":{"type":"string"},"taxExemptReason":{"type":"string"},"stock":{"type":"number"},"stockStatus":{"type":"string","enum":["available","out_of_stock"]},"satProductCode":{"type":"string"},"satUnitCode":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"}},"required":["productId","description","active","price","updatedAt"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"object","properties":{"minQuantity":{"type":"number"},"percentage":{"type":"number"}},"required":["minQuantity","percentage"],"additionalProperties":false}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"catalog","order":30,"permissions":["products:manage"]}},{"name":"update_inventory","description":"Set or restock a product inventory level. mode selects whether stock is replaced or increased.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"oneOf":[{"type":"object","properties":{"mode":{"type":"string","const":"set"},"productId":{"type":"string"},"locationId":{"type":"string"},"stock":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"note":{"type":"string"}},"required":["mode","productId","stock"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"restock"},"productId":{"type":"string"},"locationId":{"type":"string"},"quantity":{"type":"number","exclusiveMinimum":0},"note":{"type":"string"}},"required":["mode","productId","quantity"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"locationId":{"type":"string"},"locationStock":{"type":"number"},"product":{"type":"object","properties":{"productId":{"type":"string","minLength":1},"description":{"type":"string"},"sku":{"type":"string"},"code":{"type":"string"},"active":{"type":"boolean"},"price":{"type":"number"},"quantityDiscounts":{"maxItems":10,"type":"array","items":{"$ref":"#/definitions/__schema0"}},"taxIncluded":{"type":"boolean"},"taxRate":{"type":"number"},"taxability":{"type":"string"},"taxExemptReason":{"type":"string"},"stock":{"type":"number"},"stockStatus":{"type":"string","enum":["available","out_of_stock"]},"satProductCode":{"type":"string"},"satUnitCode":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"}},"required":["productId","description","active","price","updatedAt"],"additionalProperties":false}},"required":["product"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"object","properties":{"minQuantity":{"type":"number"},"percentage":{"type":"number"}},"required":["minQuantity","percentage"],"additionalProperties":false}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"catalog","order":40,"permissions":["products:manage"]}},{"name":"receive_inventory","description":"Record a multi-product supplier inventory delivery at a location.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"type":"object","properties":{"supplierId":{"$ref":"#/definitions/__schema0"},"locationId":{"$ref":"#/definitions/__schema1"},"reference":{"$ref":"#/definitions/__schema2"},"note":{"$ref":"#/definitions/__schema3"},"items":{"$ref":"#/definitions/__schema4"}},"required":["supplierId","locationId","items"],"additionalProperties":false}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","minLength":1},"__schema1":{"type":"string","minLength":1},"__schema2":{"type":"string","minLength":1,"maxLength":120},"__schema3":{"type":"string","minLength":1,"maxLength":500},"__schema4":{"minItems":1,"maxItems":50,"type":"array","items":{"$ref":"#/definitions/__schema5"}},"__schema5":{"type":"object","properties":{"productId":{"type":"string","minLength":1},"quantity":{"type":"number","exclusiveMinimum":0}},"required":["productId","quantity"],"additionalProperties":false}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"inventoryReceiptId":{"type":"string"},"itemCount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["inventoryReceiptId","itemCount"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"catalog","order":50,"permissions":["products:manage"]}},{"name":"get_price_overrides","description":"List product price overrides for one customer or business location. subjectId is the customerId from get_contacts or locationId from get_configuration.","inputSchema":{"type":"object","properties":{"input":{"type":"object","properties":{"scope":{"type":"string","enum":["customer","location"]},"subjectId":{"type":"string"},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["scope","subjectId"],"additionalProperties":false}},"required":["input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"prices":{"type":"array","items":{"type":"object","properties":{"productId":{"$ref":"#/definitions/__schema0"},"description":{"$ref":"#/definitions/__schema1"},"defaultPrice":{"$ref":"#/definitions/__schema2"},"overridePrice":{"$ref":"#/definitions/__schema3"},"taxIncluded":{"$ref":"#/definitions/__schema4"},"taxability":{"$ref":"#/definitions/__schema5"},"taxRate":{"$ref":"#/definitions/__schema6"}},"required":["productId","description","defaultPrice","overridePrice","taxIncluded"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["prices","nextCursor","hasMore"],"additionalProperties":false},{"type":"object","properties":{"prices":{"type":"array","items":{"type":"object","properties":{"productId":{"$ref":"#/definitions/__schema0"},"description":{"$ref":"#/definitions/__schema1"},"defaultPrice":{"$ref":"#/definitions/__schema2"},"overridePrice":{"$ref":"#/definitions/__schema3"},"taxIncluded":{"$ref":"#/definitions/__schema4"},"taxability":{"$ref":"#/definitions/__schema5"},"taxRate":{"$ref":"#/definitions/__schema6"}},"required":["productId","description","defaultPrice","overridePrice","taxIncluded"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["prices","nextCursor","hasMore"],"additionalProperties":false}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","minLength":1},"__schema1":{"type":"string"},"__schema2":{"type":"number"},"__schema3":{"type":"number"},"__schema4":{"type":"boolean"},"__schema5":{"type":"string"},"__schema6":{"type":"number"}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"catalog","order":60,"permissions":{"kind":"variant","selector":"input.scope","variants":{"customer":{"kind":"all-of","permissions":["customers:read"]},"location":{"kind":"all-of","permissions":["receiptOptions:read"]}}}}},{"name":"set_price_override","description":"Set or remove one product price override for a customer or location. Set price to null to restore the product default.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"oneOf":[{"type":"object","properties":{"scope":{"type":"string","const":"customer"},"customerId":{"type":"string"},"productId":{"type":"string"},"price":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["scope","customerId","productId","price"],"additionalProperties":false},{"type":"object","properties":{"scope":{"type":"string","const":"location"},"locationId":{"type":"string"},"productId":{"type":"string"},"price":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["scope","locationId","productId","price"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"scope":{"type":"string","const":"customer"},"customerId":{"type":"string"},"productId":{"$ref":"#/definitions/__schema0"},"overridePrice":{"anyOf":[{"type":"number"},{"type":"null"}]},"removed":{"type":"boolean"}},"required":["scope","customerId","productId","overridePrice","removed"],"additionalProperties":false},{"type":"object","properties":{"scope":{"type":"string","const":"location"},"locationId":{"type":"string"},"productId":{"$ref":"#/definitions/__schema0"},"overridePrice":{"anyOf":[{"type":"number"},{"type":"null"}]},"removed":{"type":"boolean"}},"required":["scope","locationId","productId","overridePrice","removed"],"additionalProperties":false}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","minLength":1}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"catalog","order":70,"permissions":["receiptPrices:manage"]}},{"name":"get_employees","description":"Search payroll employees or retrieve one employee. Search matches name, RFC, CURP, employee number, job title, or department.","inputSchema":{"type":"object","properties":{"input":{"oneOf":[{"type":"object","properties":{"operation":{"type":"string","const":"search"},"query":{"type":"string","minLength":1},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["operation"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"get"},"employeeId":{"type":"string"}},"required":["operation","employeeId"],"additionalProperties":false}]}},"required":["input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"employees":{"type":"array","items":{"$ref":"#/definitions/__schema0"}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["employees","nextCursor","hasMore"],"additionalProperties":false},{"$ref":"#/definitions/__schema0"}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1},"name":{"type":"string"},"postalCode":{"type":"string"},"taxSystem":{"type":"string"},"employeeNumber":{"type":"string"},"curp":{"type":"string"},"socialSecurityNumber":{"type":"string"},"jobTitle":{"type":"string"},"department":{"type":"string"},"paymentFrequency":{"type":"string"},"employmentStartDate":{"type":"string"},"contractType":{"type":"string"},"workScheduleType":{"type":"string"},"regimeType":{"type":"string"},"rfc":{"type":"string"},"lastPayrollDate":{"type":"string","format":"date-time"}},"required":["employeeId","name","rfc"],"additionalProperties":false}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"workspace","order":40,"permissions":["employees:read"]}},{"name":"save_employee","description":"Create or update one payroll employee. SAT catalog fields use their public business names and corresponding SAT codes.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"oneOf":[{"type":"object","properties":{"operation":{"type":"string","const":"create"},"name":{"$ref":"#/definitions/__schema0"},"rfc":{"type":"string"},"curp":{"$ref":"#/definitions/__schema1"},"postalCode":{"$ref":"#/definitions/__schema2"},"employeeNumber":{"$ref":"#/definitions/__schema3"},"employmentStartDate":{"$ref":"#/definitions/__schema4"},"taxSystem":{"$ref":"#/definitions/__schema5"},"socialSecurityNumber":{"$ref":"#/definitions/__schema6"},"contractType":{"$ref":"#/definitions/__schema7"},"regimeType":{"$ref":"#/definitions/__schema8"},"paymentFrequency":{"$ref":"#/definitions/__schema9"},"jobTitle":{"$ref":"#/definitions/__schema10"},"department":{"$ref":"#/definitions/__schema11"},"workScheduleType":{"$ref":"#/definitions/__schema12"},"positionRisk":{"$ref":"#/definitions/__schema13"},"federalEntityCode":{"$ref":"#/definitions/__schema14"},"recurringEarnings":{"$ref":"#/definitions/__schema15"},"recurringDeductions":{"$ref":"#/definitions/__schema16"},"recurringOtherPayments":{"$ref":"#/definitions/__schema17"}},"required":["operation","name","rfc","curp","postalCode","employeeNumber","employmentStartDate"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"update"},"employeeId":{"type":"string"},"name":{"allOf":[{"$ref":"#/definitions/__schema0"}]},"curp":{"allOf":[{"$ref":"#/definitions/__schema1"}]},"postalCode":{"allOf":[{"$ref":"#/definitions/__schema2"}]},"employeeNumber":{"allOf":[{"$ref":"#/definitions/__schema3"}]},"employmentStartDate":{"allOf":[{"$ref":"#/definitions/__schema4"}]},"taxSystem":{"allOf":[{"$ref":"#/definitions/__schema5"}]},"socialSecurityNumber":{"allOf":[{"$ref":"#/definitions/__schema6"}]},"contractType":{"allOf":[{"$ref":"#/definitions/__schema7"}]},"regimeType":{"allOf":[{"$ref":"#/definitions/__schema8"}]},"paymentFrequency":{"allOf":[{"$ref":"#/definitions/__schema9"}]},"jobTitle":{"allOf":[{"$ref":"#/definitions/__schema10"}]},"department":{"allOf":[{"$ref":"#/definitions/__schema11"}]},"workScheduleType":{"allOf":[{"$ref":"#/definitions/__schema12"}]},"positionRisk":{"allOf":[{"$ref":"#/definitions/__schema13"}]},"federalEntityCode":{"allOf":[{"$ref":"#/definitions/__schema14"}]},"recurringEarnings":{"allOf":[{"$ref":"#/definitions/__schema15"}]},"recurringDeductions":{"allOf":[{"$ref":"#/definitions/__schema16"}]},"recurringOtherPayments":{"allOf":[{"$ref":"#/definitions/__schema17"}]}},"required":["operation","employeeId"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string"},"__schema1":{"type":"string"},"__schema2":{"type":"string"},"__schema3":{"type":"string"},"__schema4":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"__schema5":{"type":"string","enum":["601","603","605","606","607","608","610","611","612","614","615","616","620","621","622","623","624","625","626"],"description":"Active SAT tax-system code.","x-exac-sat-catalog":"tax-systems"},"__schema6":{"type":"string"},"__schema7":{"type":"string","enum":["10","99","01","02","03","04","05","06","07","08","09"],"description":"Active SAT payroll contract-type code.","x-exac-sat-catalog":"payroll-contract-types"},"__schema8":{"type":"string","enum":["10","11","12","13","99","02","03","04","05","06","07","08","09"],"description":"Active SAT payroll regime-type code.","x-exac-sat-catalog":"payroll-regime-types"},"__schema9":{"type":"string","enum":["10","99","01","02","03","04","05","06","07","08","09"],"description":"Active SAT payroll payment-frequency code.","x-exac-sat-catalog":"payroll-payment-frequencies"},"__schema10":{"type":"string"},"__schema11":{"type":"string"},"__schema12":{"type":"string","enum":["99","01","02","03","04","05","06","07","08"],"description":"Active SAT payroll work-schedule code.","x-exac-sat-catalog":"payroll-work-schedule-types"},"__schema13":{"type":"string","enum":["1","2","3","4","5","99"],"description":"Active SAT payroll position-risk code.","x-exac-sat-catalog":"payroll-position-risks"},"__schema14":{"type":"string","enum":["AGU","BCN","BCS","CAM","CHP","CHH","COA","COL","CMX","DUR","GUA","GRO","HID","JAL","MEX","MIC","MOR","NAY","NLE","OAX","PUE","QUE","ROO","SLP","SIN","SON","TAB","TAM","TLA","VER","YUC","ZAC"],"description":"Active SAT federal-entity code.","x-exac-sat-catalog":"federal-entities"},"__schema15":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["001","002","003","004","005","006","009","010","011","012","013","014","015","019","020","021","022","023","024","025","026","027","028","029","030","031","032","033","034","035","036","037","038","039","044","045","046","047","048","049","050","051","052","053"],"description":"Active SAT payroll earning-type code.","x-exac-sat-catalog":"payroll-earning-types"},"taxableAmount":{"type":"number"},"exemptAmount":{"type":"number"}},"required":["code","taxableAmount","exemptAmount"],"additionalProperties":false}},"__schema16":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"SAT payroll deduction-type code."},"amount":{"type":"number"}},"required":["code","amount"],"additionalProperties":false}},"__schema17":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["999","001","002","003","004","005","006","007","008","009"],"description":"Active SAT payroll other-payment code.","x-exac-sat-catalog":"payroll-other-payment-types"},"amount":{"type":"number"},"employmentSubsidy":{"type":"number"}},"required":["code","amount"],"additionalProperties":false}}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1},"name":{"type":"string"},"postalCode":{"type":"string"},"taxSystem":{"type":"string"},"employeeNumber":{"type":"string"},"curp":{"type":"string"},"socialSecurityNumber":{"type":"string"},"jobTitle":{"type":"string"},"department":{"type":"string"},"paymentFrequency":{"type":"string"},"employmentStartDate":{"type":"string"},"contractType":{"type":"string"},"workScheduleType":{"type":"string"},"regimeType":{"type":"string"},"rfc":{"type":"string"},"lastPayrollDate":{"type":"string","format":"date-time"}},"required":["employeeId","name","rfc"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"workspace","order":50,"permissions":["employees:manage"]}},{"name":"get_configuration","description":"Search organization configuration or retrieve one location, expense category, or custom receipt field.","inputSchema":{"type":"object","properties":{"input":{"oneOf":[{"type":"object","properties":{"operation":{"type":"string","const":"search"},"kind":{"$ref":"#/definitions/__schema0"},"query":{"type":"string","minLength":1},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["operation","kind"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"get"},"kind":{"$ref":"#/definitions/__schema0"},"entryId":{"type":"string"}},"required":["operation","kind","entryId"],"additionalProperties":false}]}},"required":["input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","enum":["location","sales_receipt_field","expense_category"],"description":"location is a business location; expense_category classifies expenses; sales_receipt_field configures custom receipt data"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"locations":{"type":"array","items":{"$ref":"#/definitions/__schema0"}},"nextCursor":{"$ref":"#/definitions/__schema2"},"hasMore":{"$ref":"#/definitions/__schema3"}},"required":["locations","nextCursor","hasMore"],"additionalProperties":false},{"type":"object","properties":{"categories":{"type":"array","items":{"$ref":"#/definitions/__schema4"}},"nextCursor":{"$ref":"#/definitions/__schema2"},"hasMore":{"$ref":"#/definitions/__schema3"}},"required":["categories","nextCursor","hasMore"],"additionalProperties":false},{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/definitions/__schema5"}},"nextCursor":{"$ref":"#/definitions/__schema2"},"hasMore":{"$ref":"#/definitions/__schema3"}},"required":["fields","nextCursor","hasMore"],"additionalProperties":false},{"anyOf":[{"$ref":"#/definitions/__schema0"},{"$ref":"#/definitions/__schema4"},{"$ref":"#/definitions/__schema5"}]}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"object","properties":{"locationId":{"type":"string","minLength":1},"name":{"type":"string"},"folioPrefix":{"type":"string"},"timeZone":{"type":"string"},"address":{"type":"object","properties":{"formattedAddress":{"type":"string"},"street":{"type":"string"},"exterior":{"type":"string"},"interior":{"type":"string"},"neighborhood":{"type":"string"},"city":{"type":"string"},"municipality":{"type":"string"},"state":{"type":"string"},"zip":{"type":"string"},"country":{"type":"string"},"placeId":{"type":"string"}},"additionalProperties":false},"pin":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180}},"required":["latitude","longitude"],"additionalProperties":false},"radiusMeters":{"type":"number","minimum":0},"updatedAt":{"$ref":"#/definitions/__schema1"}},"required":["locationId","name","updatedAt"],"additionalProperties":false},"__schema1":{"type":"string","format":"date-time"},"__schema2":{"anyOf":[{"type":"string"},{"type":"null"}]},"__schema3":{"type":"boolean"},"__schema4":{"type":"object","properties":{"categoryId":{"type":"string","minLength":1},"name":{"type":"string"},"updatedAt":{"$ref":"#/definitions/__schema1"}},"required":["categoryId","name","updatedAt"],"additionalProperties":false},"__schema5":{"type":"object","properties":{"fieldId":{"type":"string","minLength":1},"name":{"type":"string"},"type":{"type":"string","enum":["select","checkbox"]},"required":{"type":"boolean"},"order":{"type":"number"},"values":{"type":"array","items":{"type":"string"}}},"required":["fieldId","name","type","required","order","values"],"additionalProperties":false}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"setup","order":10,"permissions":{"kind":"variant","selector":"input.kind","variants":{"location":{"kind":"all-of","permissions":["receiptOptions:read"]},"expense_category":{"kind":"all-of","permissions":["expenses:read"]},"sales_receipt_field":{"kind":"all-of","permissions":["receiptOptions:read"]}}}}},{"name":"search_sat_product_catalog","description":"Search the official SAT product and service-key catalog by description or key.","inputSchema":{"type":"object","properties":{"query":{"type":"string","minLength":2},"limit":{"type":"integer","minimum":1,"maximum":50}},"required":["query"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"description":{"type":"string"},"score":{"type":"number"}},"required":["key","description","score"],"additionalProperties":false}},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["data","total"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"setup","order":20,"permissions":["products:read"]}},{"name":"save_configuration","description":"Create or update one organization configuration entry: a location, expense category, or custom receipt field.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"anyOf":[{"type":"object","properties":{"operation":{"type":"string","const":"create"},"kind":{"type":"string","const":"location"},"name":{"$ref":"#/definitions/__schema0"},"folioPrefix":{"$ref":"#/definitions/__schema1"},"timeZone":{"$ref":"#/definitions/__schema3"}},"required":["operation","kind","name"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"update"},"kind":{"type":"string","const":"location"},"entryId":{"type":"string"},"name":{"$ref":"#/definitions/__schema0"},"folioPrefix":{"$ref":"#/definitions/__schema1"},"timeZone":{"$ref":"#/definitions/__schema3"}},"required":["operation","kind","entryId","name"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"create"},"kind":{"type":"string","const":"expense_category"},"name":{"type":"string","minLength":1}},"required":["operation","kind","name"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"update"},"kind":{"type":"string","const":"expense_category"},"entryId":{"type":"string"},"name":{"type":"string","minLength":1}},"required":["operation","kind","entryId","name"],"additionalProperties":false},{"type":"object","properties":{"operation":{"$ref":"#/definitions/__schema5"},"kind":{"$ref":"#/definitions/__schema6"},"name":{"$ref":"#/definitions/__schema7"},"fieldType":{"$ref":"#/definitions/__schema8"},"required":{"$ref":"#/definitions/__schema9"},"values":{"$ref":"#/definitions/__schema10"}},"required":["operation","kind","name","fieldType","required"],"additionalProperties":false},{"type":"object","properties":{"operation":{"$ref":"#/definitions/__schema11"},"kind":{"$ref":"#/definitions/__schema12"},"entryId":{"$ref":"#/definitions/__schema13"},"name":{"$ref":"#/definitions/__schema7"},"fieldType":{"$ref":"#/definitions/__schema8"},"required":{"$ref":"#/definitions/__schema9"},"values":{"$ref":"#/definitions/__schema10"}},"required":["operation","kind","entryId","name","fieldType","required"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","minLength":1},"__schema1":{"description":"Location-only receipt folio prefix","allOf":[{"$ref":"#/definitions/__schema2"}]},"__schema2":{"type":"string"},"__schema3":{"description":"Location-only IANA time zone; null clears it","allOf":[{"$ref":"#/definitions/__schema4"}]},"__schema4":{"anyOf":[{"type":"string"},{"type":"null"}]},"__schema5":{"type":"string","const":"create"},"__schema6":{"type":"string","const":"sales_receipt_field"},"__schema7":{"type":"string","minLength":1},"__schema8":{"type":"string","enum":["select","checkbox"]},"__schema9":{"type":"boolean"},"__schema10":{"type":"array","items":{"type":"string","minLength":1}},"__schema11":{"type":"string","const":"update"},"__schema12":{"type":"string","const":"sales_receipt_field"},"__schema13":{"type":"string"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"locationId":{"type":"string","minLength":1},"name":{"type":"string"},"folioPrefix":{"type":"string"},"timeZone":{"type":"string"},"address":{"type":"object","properties":{"formattedAddress":{"type":"string"},"street":{"type":"string"},"exterior":{"type":"string"},"interior":{"type":"string"},"neighborhood":{"type":"string"},"city":{"type":"string"},"municipality":{"type":"string"},"state":{"type":"string"},"zip":{"type":"string"},"country":{"type":"string"},"placeId":{"type":"string"}},"additionalProperties":false},"pin":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180}},"required":["latitude","longitude"],"additionalProperties":false},"radiusMeters":{"type":"number","minimum":0},"updatedAt":{"$ref":"#/definitions/__schema0"}},"required":["locationId","name","updatedAt"],"additionalProperties":false},{"type":"object","properties":{"categoryId":{"type":"string","minLength":1},"name":{"type":"string"},"updatedAt":{"$ref":"#/definitions/__schema0"}},"required":["categoryId","name","updatedAt"],"additionalProperties":false},{"type":"object","properties":{"fieldId":{"type":"string","minLength":1},"name":{"type":"string"},"type":{"type":"string","enum":["select","checkbox"]},"required":{"type":"boolean"},"order":{"type":"number"},"values":{"type":"array","items":{"type":"string"}}},"required":["fieldId","name","type","required","order","values"],"additionalProperties":false}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","format":"date-time"}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"setup","order":30,"permissions":{"kind":"variant","selector":"input.kind","variants":{"location":{"kind":"all-of","permissions":["receiptLocations:manage"]},"expense_category":{"kind":"all-of","permissions":["expenses:manage"]},"sales_receipt_field":{"kind":"all-of","permissions":["receiptFields:manage"]}}}}},{"name":"create_expense","description":"Create an operational expense. Credit expenses require supplierId, paymentForm 99, and settlement terms; pay supplier-linked credit expenses with record_payment.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"oneOf":[{"type":"object","properties":{"description":{"$ref":"#/definitions/__schema0"},"amount":{"$ref":"#/definitions/__schema1"},"categoryName":{"$ref":"#/definitions/__schema2"},"locationId":{"$ref":"#/definitions/__schema3"},"businessDate":{"$ref":"#/definitions/__schema4"},"notes":{"$ref":"#/definitions/__schema5"},"supplierId":{"type":"string"},"settlementMode":{"type":"string","const":"paid"},"paymentForm":{"type":"string","enum":["12","13","14","15","17","23","24","25","26","27","28","29","30","31","99","02","06","01","05","04","03","08"],"description":"Active SAT payment-form code.","x-exac-sat-catalog":"payment-forms"}},"required":["description","amount","categoryName","businessDate","settlementMode","paymentForm"],"additionalProperties":false},{"type":"object","properties":{"description":{"$ref":"#/definitions/__schema0"},"amount":{"$ref":"#/definitions/__schema1"},"categoryName":{"$ref":"#/definitions/__schema2"},"locationId":{"$ref":"#/definitions/__schema3"},"businessDate":{"$ref":"#/definitions/__schema4"},"notes":{"$ref":"#/definitions/__schema5"},"supplierId":{"type":"string"},"settlementMode":{"type":"string","const":"credit"},"paymentForm":{"type":"string","const":"99"},"settlementTerms":{"type":"object","properties":{"installmentCount":{"type":"integer","minimum":1,"maximum":60},"firstDue":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"transaction_date"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"months_after_transaction"},"months":{"type":"integer","minimum":1,"maximum":60}},"required":["kind","months"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"fixed_date"},"date":{"type":"string"}},"required":["kind","date"],"additionalProperties":false}]},"recurrence":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"anchor_day"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"day_of_month"},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["kind","day"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"last_day"}},"required":["kind"],"additionalProperties":false}]}},"required":["installmentCount","firstDue","recurrence"],"additionalProperties":false}},"required":["description","amount","categoryName","businessDate","supplierId","settlementMode","paymentForm","settlementTerms"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","minLength":1},"__schema1":{"type":"number","exclusiveMinimum":0},"__schema2":{"type":"string","minLength":1},"__schema3":{"type":"string"},"__schema4":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Accounting date in YYYY-MM-DD format"},"__schema5":{"type":"string"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^expense:.+$"},"settlementMode":{"type":"string","enum":["credit","paid"]}},"required":["documentRef","settlementMode"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"accounting","order":10,"permissions":["expenses:manage"]}},{"name":"correct_expense_settlement","description":"Set whether an expense is paid or remains on supplier credit. Paid expenses cannot use payment form 99; credit expenses must use 99.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"oneOf":[{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^expense:.+$"},"settlementMode":{"type":"string","const":"paid"},"paymentForm":{"type":"string","enum":["12","13","14","15","17","23","24","25","26","27","28","29","30","31","99","02","06","01","05","04","03","08"],"description":"Active SAT payment-form code.","x-exac-sat-catalog":"payment-forms"}},"required":["documentRef","settlementMode","paymentForm"],"additionalProperties":false},{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^expense:.+$"},"settlementMode":{"type":"string","const":"credit"},"paymentForm":{"type":"string","const":"99"}},"required":["documentRef","settlementMode","paymentForm"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^expense:.+$"},"settlementMode":{"type":"string","enum":["credit","paid"]}},"required":["documentRef","settlementMode"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"accounting","order":20,"permissions":["expenses:manage"]}},{"name":"create_sales_receipt","description":"Create a POS sale receipt. A non-courtesy sale requires paymentForm; credit sales require paymentForm 99 and a stored customer.customerId with credit enabled. This operation never stamps a CFDI.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"oneOf":[{"type":"object","properties":{"items":{"$ref":"#/definitions/__schema0"},"currency":{"$ref":"#/definitions/__schema2"},"locationId":{"$ref":"#/definitions/__schema3"},"pricesIncludeIva":{"$ref":"#/definitions/__schema4"},"notes":{"$ref":"#/definitions/__schema5"},"customFields":{"$ref":"#/definitions/__schema6"},"invoiceRequested":{"type":"boolean"},"saleType":{"type":"string","const":"paid"},"paymentForm":{"type":"string","enum":["12","13","14","15","17","23","24","25","26","27","28","29","30","31","99","02","06","01","05","04","03","08"],"description":"Active SAT payment-form code.","x-exac-sat-catalog":"payment-forms"},"customer":{"allOf":[{"$ref":"#/definitions/__schema7"}]}},"required":["items","saleType","paymentForm"],"additionalProperties":false},{"type":"object","properties":{"items":{"$ref":"#/definitions/__schema0"},"currency":{"$ref":"#/definitions/__schema2"},"locationId":{"$ref":"#/definitions/__schema3"},"pricesIncludeIva":{"$ref":"#/definitions/__schema4"},"notes":{"$ref":"#/definitions/__schema5"},"customFields":{"$ref":"#/definitions/__schema6"},"invoiceRequested":{"type":"boolean"},"saleType":{"type":"string","const":"credit"},"paymentForm":{"type":"string","const":"99"},"customer":{"type":"object","properties":{"kind":{"type":"string","const":"stored"},"customerId":{"type":"string","minLength":1}},"required":["kind","customerId"],"additionalProperties":false},"collection":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"due_date"},"date":{"type":"string"}},"required":["kind","date"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"installments"},"terms":{"type":"object","properties":{"installmentCount":{"type":"integer","minimum":1,"maximum":60},"firstDue":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"transaction_date"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"months_after_transaction"},"months":{"type":"integer","minimum":1,"maximum":60}},"required":["kind","months"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"fixed_date"},"date":{"type":"string"}},"required":["kind","date"],"additionalProperties":false}]},"recurrence":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"anchor_day"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"day_of_month"},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["kind","day"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"last_day"}},"required":["kind"],"additionalProperties":false}]}},"required":["installmentCount","firstDue","recurrence"],"additionalProperties":false}},"required":["kind","terms"],"additionalProperties":false}]}},"required":["items","saleType","paymentForm","customer"],"additionalProperties":false},{"type":"object","properties":{"items":{"$ref":"#/definitions/__schema0"},"currency":{"$ref":"#/definitions/__schema2"},"locationId":{"$ref":"#/definitions/__schema3"},"pricesIncludeIva":{"$ref":"#/definitions/__schema4"},"notes":{"$ref":"#/definitions/__schema5"},"customFields":{"$ref":"#/definitions/__schema6"},"invoiceRequested":{"type":"boolean","const":false},"saleType":{"type":"string","const":"courtesy"},"customer":{"allOf":[{"$ref":"#/definitions/__schema7"}]}},"required":["items","saleType"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema1"}},"__schema1":{"type":"object","properties":{"productId":{"type":"string"},"description":{"type":"string","minLength":1},"quantity":{"type":"number","exclusiveMinimum":0},"unitPrice":{"type":"number","minimum":0},"discount":{"type":"number"},"taxIncluded":{"type":"boolean"}},"required":["description","quantity","unitPrice"],"additionalProperties":false},"__schema2":{"type":"string","pattern":"^[A-Z]{3}$"},"__schema3":{"type":"string"},"__schema4":{"type":"boolean"},"__schema5":{"type":"string"},"__schema6":{"type":"array","items":{"type":"object","properties":{"fieldName":{"type":"string","minLength":1},"value":{"type":"string"}},"required":["fieldName","value"],"additionalProperties":false}},"__schema7":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"stored"},"customerId":{"type":"string","minLength":1}},"required":["kind","customerId"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"walk_in"},"name":{"type":"string","minLength":1},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["kind"],"additionalProperties":false}]}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^sales_receipt:.+$"},"status":{"type":"string","enum":["open","invoiced","global_invoiced","canceled"]}},"required":["documentRef","status"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"sales","order":60,"permissions":["receipts:create"]}},{"name":"cancel_sales_receipt","description":"Cancel an open receipt while preserving its operational history.","inputSchema":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^sales_receipt:.+$"},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."}},"required":["documentRef","idempotencyKey"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^sales_receipt:.+$"},"status":{"type":"string","enum":["open","invoiced","global_invoiced","canceled"]}},"required":["documentRef","status"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"sales","order":70,"permissions":["receipts:cancel"]}},{"name":"refund_sales_receipt","description":"Register a receipt refund. A refund may create a CFDI credit note; use the returned receipt refund document to follow its lifecycle.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"reason":{"type":"string","enum":["commercial_refund","resico_reconciliation"]},"settlementMethod":{"type":"string","enum":["cash","transfer","original_method","customer_credit"]},"allocations":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema0"}},"note":{"type":"string"},"documentRef":{"type":"string","pattern":"^sales_receipt:.+$"}},"required":["amount","reason","settlementMethod","documentRef"],"additionalProperties":false}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"original_line"},"lineRef":{"type":"string","minLength":1},"adjustmentMode":{"type":"string","const":"quantity"},"quantity":{"type":"number","exclusiveMinimum":0}},"required":["kind","lineRef","adjustmentMode","quantity"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"original_line"},"lineRef":{"type":"string","minLength":1},"adjustmentMode":{"type":"string","const":"amount"},"amount":{"type":"number","exclusiveMinimum":0}},"required":["kind","lineRef","adjustmentMode","amount"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"custom"},"description":{"type":"string","minLength":1},"quantity":{"type":"number","exclusiveMinimum":0},"amount":{"type":"number","exclusiveMinimum":0},"productKey":{"type":"string","minLength":1},"unitKey":{"type":"string","minLength":1},"taxability":{"type":"string","enum":["standard","zero","exempt"]},"taxRate":{"type":"number","minimum":0,"maximum":1},"taxIncluded":{"type":"boolean"}},"required":["kind","description","quantity","amount","productKey","unitKey","taxability","taxRate","taxIncluded"],"additionalProperties":false}]}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^sales_receipt_refund:.+$"},"status":{"type":"string","enum":["pending","processing","completed","failed","recovery_required","canceled"]}},"required":["documentRef","status"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"sales","order":80,"permissions":["receipts:refund"]}},{"name":"create_cfdi_draft_from_sales_receipts","description":"Create a CFDI draft from one or more compatible open sales receipts. Inspect the receipts first; they must match on customer, currency, payment form, and payment timing. This operation never stamps or sends the CFDI.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"type":"object","properties":{"salesReceiptRefs":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema0"},"description":"One or more open receipt documentRefs from search_documents"},"customer":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"existing"},"customerId":{"type":"string","minLength":1}},"required":["kind","customerId"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"public_general"}},"required":["kind"],"additionalProperties":false}]},"cfdiUse":{"type":"string","enum":["G01","D06","I07","I06","I01","I05","D09","G02","D04","I04","I03","D08","G03","D03","D02","D01","D05","I02","CN01","I08","CP01","D10","D07","S01"],"description":"Active SAT CFDI-use code.","x-exac-sat-catalog":"cfdi-uses"},"acknowledgeReconciliationDifference":{"description":"Required only after reviewing a reported fiscal difference","allOf":[{"$ref":"#/definitions/__schema1"}]},"reconciliationNote":{"type":"string","minLength":1},"paymentScheduleReplacement":{"description":"Required when batching credit receipts that already have operational payment schedules. Replaces them with one acknowledged invoice schedule.","allOf":[{"$ref":"#/definitions/__schema2"}]},"remediation":{"type":"object","properties":{"customerFiscalIdentity":{"$ref":"#/definitions/__schema3"},"receiptItems":{"$ref":"#/definitions/__schema4"}},"additionalProperties":false,"description":"Supply only when validation reports missing customer or item fiscal identity. Use the receipt reference and zero-based item index reported in details.issues."}},"required":["salesReceiptRefs","customer","cfdiUse"],"additionalProperties":false}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","pattern":"^sales_receipt:.*"},"__schema1":{"type":"boolean"},"__schema2":{"type":"object","properties":{"acknowledged":{"type":"boolean","const":true},"settlementTerms":{"type":"object","properties":{"installmentCount":{"type":"integer","minimum":1,"maximum":60},"firstDue":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"transaction_date"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"months_after_transaction"},"months":{"type":"integer","minimum":1,"maximum":60}},"required":["kind","months"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"fixed_date"},"date":{"type":"string"}},"required":["kind","date"],"additionalProperties":false}]},"recurrence":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"anchor_day"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"day_of_month"},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["kind","day"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"last_day"}},"required":["kind"],"additionalProperties":false}]}},"required":["installmentCount","firstDue","recurrence"],"additionalProperties":false},"reason":{"type":"string","minLength":3,"maxLength":500}},"required":["acknowledged","settlementTerms","reason"],"additionalProperties":false},"__schema3":{"type":"object","properties":{"rfc":{"type":"string","minLength":1},"taxSystem":{"type":"string","enum":["601","603","605","606","607","608","610","611","612","614","615","616","620","621","622","623","624","625","626"],"description":"Active SAT tax-system code.","x-exac-sat-catalog":"tax-systems"},"postalCode":{"type":"string","minLength":1}},"additionalProperties":false},"__schema4":{"type":"array","items":{"type":"object","properties":{"salesReceiptRef":{"type":"string","pattern":"^sales_receipt:.*"},"items":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991},"satProductCode":{"type":"string","minLength":1},"satUnitCode":{"type":"string","minLength":1},"saveToProduct":{"type":"boolean"}},"required":["index","satProductCode","satUnitCode"],"additionalProperties":false}}},"required":["salesReceiptRef","items"],"additionalProperties":false}}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"cfdi":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^cfdi:.+$"},"kind":{"type":"string","enum":["income","credit_note","transfer","payroll","payment_complement"]},"status":{"type":"string","const":"draft"}},"required":["documentRef","kind","status"],"additionalProperties":false},"salesReceiptRefs":{"type":"array","items":{"type":"string","pattern":"^sales_receipt:.+$"}},"reconciliationDifference":{"type":"number"}},"required":["cfdi","salesReceiptRefs"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"cfdi","order":20,"permissions":["invoices:manage","receipts:read"]}},{"name":"save_quote","description":"Create a draft quote or update an existing quote. operation selects create or update; documentRef is required only for update.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"oneOf":[{"type":"object","properties":{"operation":{"type":"string","const":"create"},"customerId":{"$ref":"#/definitions/__schema0"},"customerName":{"$ref":"#/definitions/__schema1"},"customerEmail":{"$ref":"#/definitions/__schema2"},"locationId":{"$ref":"#/definitions/__schema3"},"validUntil":{"$ref":"#/definitions/__schema4"},"items":{"$ref":"#/definitions/__schema5"},"notes":{"$ref":"#/definitions/__schema8"},"settlementTerms":{"$ref":"#/definitions/__schema9"}},"required":["operation","validUntil","items"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"update"},"documentRef":{"type":"string","pattern":"^quote:.+$"},"customerId":{"$ref":"#/definitions/__schema0"},"customerName":{"$ref":"#/definitions/__schema1"},"customerEmail":{"$ref":"#/definitions/__schema2"},"locationId":{"$ref":"#/definitions/__schema3"},"validUntil":{"$ref":"#/definitions/__schema4"},"items":{"$ref":"#/definitions/__schema5"},"notes":{"$ref":"#/definitions/__schema8"},"settlementTerms":{"$ref":"#/definitions/__schema9"}},"required":["operation","documentRef","validUntil","items"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","minLength":1},"__schema1":{"type":"string","minLength":1,"description":"Recipient name when no stored customer is selected."},"__schema2":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"__schema3":{"type":"string","minLength":1},"__schema4":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"__schema5":{"minItems":1,"maxItems":50,"type":"array","items":{"$ref":"#/definitions/__schema6"}},"__schema6":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"product"},"productId":{"type":"string","minLength":1},"quantity":{"type":"number","exclusiveMinimum":0},"discount":{"$ref":"#/definitions/__schema7"}},"required":["kind","productId","quantity"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"custom"},"description":{"type":"string","minLength":1},"quantity":{"type":"number","exclusiveMinimum":0},"unitPrice":{"type":"number","exclusiveMinimum":0},"discount":{"$ref":"#/definitions/__schema7"},"satProductCode":{"type":"string","minLength":1},"satUnitCode":{"type":"string","minLength":1},"unitName":{"type":"string","minLength":1},"taxIncluded":{"type":"boolean"},"taxability":{"type":"string","enum":["standard","zero","exempt"]},"taxRate":{"type":"number","minimum":0,"maximum":1}},"required":["kind","description","quantity","unitPrice","satProductCode"],"additionalProperties":false}]},"__schema7":{"type":"number","minimum":0},"__schema8":{"type":"string"},"__schema9":{"type":"object","properties":{"installmentCount":{"type":"integer","minimum":1,"maximum":60},"firstDue":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"transaction_date"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"months_after_transaction"},"months":{"type":"integer","minimum":1,"maximum":60}},"required":["kind","months"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"fixed_date"},"date":{"type":"string"}},"required":["kind","date"],"additionalProperties":false}]},"recurrence":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"anchor_day"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"day_of_month"},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["kind","day"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"last_day"}},"required":["kind"],"additionalProperties":false}]}},"required":["installmentCount","firstDue","recurrence"],"additionalProperties":false}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^quote:.+$"},"status":{"type":"string","enum":["draft","sent","accepted","converted","expired","canceled"]}},"required":["documentRef","status"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"sales","order":10,"permissions":["quotes:manage"]}},{"name":"publish_quote","description":"Publish a quote to the customer portal.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"documentRef":{"type":"string","pattern":"^quote:.+$"}},"required":["idempotencyKey","documentRef"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^quote:.+$"},"status":{"type":"string","enum":["draft","sent","accepted","converted","expired","canceled"]},"portalUrl":{"type":"string","format":"uri"}},"required":["documentRef","status","portalUrl"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"sales","order":20,"permissions":["quotes:manage"]}},{"name":"cancel_quote","description":"Cancel a draft or sent quote.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"documentRef":{"type":"string","pattern":"^quote:.+$"}},"required":["idempotencyKey","documentRef"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^quote:.+$"},"status":{"type":"string","enum":["draft","sent","accepted","converted","expired","canceled"]}},"required":["documentRef","status"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"sales","order":30,"permissions":["quotes:manage"]}},{"name":"record_quote_payment","description":"Record a manual payment for an accepted quote.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"type":"object","properties":{"paymentForm":{"type":"string","enum":["12","13","14","15","17","23","24","25","26","27","28","29","30","31","99","02","06","01","05","04","03","08"],"description":"Active SAT payment-form code.","x-exac-sat-catalog":"payment-forms"},"paidAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"notes":{"type":"string"},"documentRef":{"type":"string","pattern":"^quote:.+$"}},"required":["paymentForm","documentRef"],"additionalProperties":false}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"paymentId":{"type":"string"},"source":{"type":"string","enum":["manual","online"]},"amount":{"type":"number"},"currency":{"type":"string","const":"MXN"},"paymentForm":{"type":"string"},"applicationStatus":{"type":"string","enum":["pending","processing","applied","failed","conflict"]},"applicationErrorCode":{"type":"string","enum":["payment_form_required","fiscal_drift","location_resolution_required","duplicate_payment","application_failed"]},"invoiceStatus":{"type":"string","enum":["pending","processing","issued","failed"]},"salesReceiptDocumentRef":{"type":"string","pattern":"^sales_receipt:.+$"},"cfdiDocumentRef":{"type":"string","pattern":"^cfdi:.+$"},"paidAt":{"type":"string","format":"date-time"}},"required":["paymentId","source","amount","currency","applicationStatus","paidAt"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"sales","order":40,"permissions":["quotes:manage"]}},{"name":"create_withholding","description":"Create and immediately stamp a SAT withholding document. Each tax entry uses business names for tax and paymentType; withholdingTypeCode is the explicit SAT catalog code. This operation has no draft mode.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"type":"object","properties":{"customerId":{"$ref":"#/definitions/__schema0"},"withholdingTypeCode":{"$ref":"#/definitions/__schema1"},"period":{"$ref":"#/definitions/__schema2"},"operationAmount":{"$ref":"#/definitions/__schema6"},"exemptAmount":{"$ref":"#/definitions/__schema7"},"taxes":{"$ref":"#/definitions/__schema9"},"issuedLocalDateTime":{"$ref":"#/definitions/__schema14"},"description":{"$ref":"#/definitions/__schema15"},"internalFolio":{"$ref":"#/definitions/__schema17"},"pdfCustomSection":{"$ref":"#/definitions/__schema18"}},"required":["customerId","withholdingTypeCode","period","operationAmount","taxes"],"additionalProperties":false}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","minLength":1},"__schema1":{"type":"string","enum":["10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","01","02","03","04","05","06","07","08","09"],"description":"Active SAT withholding-type code.","x-exac-sat-catalog":"withholding-types"},"__schema2":{"type":"object","properties":{"fromMonth":{"$ref":"#/definitions/__schema3"},"toMonth":{"$ref":"#/definitions/__schema4"},"year":{"$ref":"#/definitions/__schema5"}},"required":["fromMonth","toMonth","year"],"additionalProperties":false},"__schema3":{"type":"integer","minimum":1,"maximum":12},"__schema4":{"type":"integer","minimum":1,"maximum":12},"__schema5":{"type":"integer","minimum":2000,"maximum":2100},"__schema6":{"type":"number","exclusiveMinimum":0,"description":"Operation amount in pesos"},"__schema7":{"description":"Exempt amount in pesos; defaults to zero","allOf":[{"$ref":"#/definitions/__schema8"}]},"__schema8":{"type":"number","minimum":0},"__schema9":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema10"}},"__schema10":{"type":"object","properties":{"tax":{"$ref":"#/definitions/__schema11"},"amount":{"$ref":"#/definitions/__schema12"},"paymentType":{"$ref":"#/definitions/__schema13"}},"required":["tax","amount","paymentType"],"additionalProperties":false},"__schema11":{"type":"string","enum":["isr","iva","ieps"]},"__schema12":{"type":"number","exclusiveMinimum":0,"description":"Amount retained in pesos"},"__schema13":{"type":"string","enum":["definitive","provisional"]},"__schema14":{"type":"string","pattern":"^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})(?:\\.(\\d{1,9}))?$"},"__schema15":{"description":"Required when withholdingTypeCode is 25","allOf":[{"$ref":"#/definitions/__schema16"}]},"__schema16":{"type":"string","minLength":1},"__schema17":{"type":"string","minLength":1},"__schema18":{"type":"string"}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^withholding:.+$"},"status":{"type":"string","const":"valid"}},"required":["documentRef","status"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"cfdi","order":10,"permissions":["invoices:manage"]}},{"name":"create_cfdi_draft","description":"Create a CFDI draft with canonical tax validation. Payment complements accept automatic taxes for known CFDIs or caller-provided taxObject and payment-level tax entries for external CFDIs. This tool never stamps.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"oneOf":[{"type":"object","properties":{"pdfCustomSection":{"$ref":"#/definitions/__schema0"},"currency":{"$ref":"#/definitions/__schema1"},"customerId":{"$ref":"#/definitions/__schema2"},"items":{"$ref":"#/definitions/__schema3"},"kind":{"$ref":"#/definitions/__schema7"},"cfdiUse":{"$ref":"#/definitions/__schema8"},"payment":{"$ref":"#/definitions/__schema9"}},"required":["customerId","items","kind","cfdiUse","payment"],"additionalProperties":false,"title":"CFDI I · income"},{"type":"object","properties":{"pdfCustomSection":{"$ref":"#/definitions/__schema0"},"currency":{"$ref":"#/definitions/__schema1"},"customerId":{"$ref":"#/definitions/__schema2"},"items":{"$ref":"#/definitions/__schema3"},"kind":{"$ref":"#/definitions/__schema12"},"formCode":{"$ref":"#/definitions/__schema10"},"methodCode":{"$ref":"#/definitions/__schema13"},"relatedDocuments":{"$ref":"#/definitions/__schema14"}},"required":["customerId","items","kind","formCode","relatedDocuments"],"additionalProperties":false,"title":"CFDI E · credit_note"},{"type":"object","properties":{"pdfCustomSection":{"$ref":"#/definitions/__schema0"},"currency":{"$ref":"#/definitions/__schema1"},"customerId":{"$ref":"#/definitions/__schema2"},"items":{"$ref":"#/definitions/__schema3"},"kind":{"$ref":"#/definitions/__schema17"}},"required":["customerId","items","kind"],"additionalProperties":false,"title":"CFDI T · transfer"},{"type":"object","properties":{"pdfCustomSection":{"$ref":"#/definitions/__schema0"},"currency":{"$ref":"#/definitions/__schema1"},"kind":{"$ref":"#/definitions/__schema18"},"employeeId":{"$ref":"#/definitions/__schema19"},"payroll":{"$ref":"#/definitions/__schema20"}},"required":["kind","employeeId","payroll"],"additionalProperties":false,"title":"CFDI N · payroll"},{"type":"object","properties":{"pdfCustomSection":{"$ref":"#/definitions/__schema0"},"kind":{"$ref":"#/definitions/__schema22"},"customerId":{"$ref":"#/definitions/__schema23"},"payment":{"$ref":"#/definitions/__schema24"}},"required":["kind","customerId","payment"],"additionalProperties":false,"title":"CFDI P · payment_complement"}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string"},"__schema1":{"type":"string","minLength":3,"maxLength":3},"__schema2":{"type":"string","minLength":1},"__schema3":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema4"}},"__schema4":{"oneOf":[{"$ref":"#/definitions/__schema5"},{"$ref":"#/definitions/__schema6"}]},"__schema5":{"type":"object","properties":{"kind":{"type":"string","const":"product"},"productId":{"type":"string","minLength":1,"description":"Existing Exac product ID"},"quantity":{"type":"number","exclusiveMinimum":0},"unitPrice":{"type":"number","minimum":0,"description":"Unit price in pesos"},"discount":{"type":"number","minimum":0},"taxIncluded":{"type":"boolean"}},"required":["kind","productId","quantity","unitPrice"],"additionalProperties":false},"__schema6":{"type":"object","properties":{"kind":{"type":"string","const":"custom"},"description":{"type":"string","minLength":1},"quantity":{"type":"number","exclusiveMinimum":0},"unitPrice":{"type":"number","minimum":0,"description":"Unit price in pesos"},"satProductCode":{"type":"string","minLength":1,"description":"SAT product/service code"},"satUnitCode":{"type":"string","minLength":1,"description":"SAT unit code"},"discount":{"type":"number","minimum":0},"taxIncluded":{"type":"boolean"},"taxRate":{"type":"number","minimum":0,"maximum":1},"taxability":{"type":"string","enum":["standard","zero","exempt"]}},"required":["kind","description","quantity","unitPrice","satProductCode","satUnitCode"],"additionalProperties":false},"__schema7":{"type":"string","const":"income"},"__schema8":{"type":"string","enum":["G01","D06","I07","I06","I01","I05","D09","G02","D04","I04","I03","D08","G03","D03","D02","D01","D05","I02","CN01","I08","CP01","D10","D07","S01"],"description":"Active SAT CFDI-use code.","x-exac-sat-catalog":"cfdi-uses"},"__schema9":{"oneOf":[{"type":"object","properties":{"timing":{"type":"string","const":"single_payment"},"formCode":{"$ref":"#/definitions/__schema10"},"conditions":{"type":"string","maxLength":1000}},"required":["timing","formCode"],"additionalProperties":false},{"type":"object","properties":{"timing":{"type":"string","const":"deferred_or_installments"},"formCode":{"type":"string","const":"99"},"dueDate":{"description":"Calendar date in YYYY-MM-DD format","allOf":[{"$ref":"#/definitions/__schema11"}]},"settlementTerms":{"type":"object","properties":{"installmentCount":{"type":"integer","minimum":1,"maximum":60},"firstDue":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"transaction_date"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"months_after_transaction"},"months":{"type":"integer","minimum":1,"maximum":60}},"required":["kind","months"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"fixed_date"},"date":{"type":"string"}},"required":["kind","date"],"additionalProperties":false}]},"recurrence":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"anchor_day"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"day_of_month"},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["kind","day"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"last_day"}},"required":["kind"],"additionalProperties":false}]}},"required":["installmentCount","firstDue","recurrence"],"additionalProperties":false},"conditions":{"type":"string","maxLength":1000}},"required":["timing","formCode"],"additionalProperties":false}]},"__schema10":{"type":"string","enum":["12","13","14","15","17","23","24","25","26","27","28","29","30","31","99","02","06","01","05","04","03","08"],"description":"Active SAT payment-form code.","x-exac-sat-catalog":"payment-forms"},"__schema11":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"__schema12":{"type":"string","const":"credit_note"},"__schema13":{"type":"string","enum":["PPD","PUE"],"description":"Active SAT payment-method code. Defaults to PUE when omitted.","x-exac-sat-catalog":"payment-methods"},"__schema14":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema15"}},"__schema15":{"type":"object","properties":{"relationship":{"type":"string","enum":["07","03","06","01","02","04","05"],"description":"Active SAT CFDI relationship-type code.","x-exac-sat-catalog":"relationship-types"},"documents":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema16"},"description":"Related CFDI UUIDs"}},"required":["relationship","documents"],"additionalProperties":false},"__schema16":{"type":"string","minLength":1},"__schema17":{"type":"string","const":"transfer"},"__schema18":{"type":"string","const":"payroll"},"__schema19":{"type":"string","minLength":1},"__schema20":{"type":"object","properties":{"paidOn":{"$ref":"#/definitions/__schema11"},"periodStartedOn":{"allOf":[{"$ref":"#/definitions/__schema11"}]},"periodEndedOn":{"allOf":[{"$ref":"#/definitions/__schema11"}]},"paidDays":{"type":"number","exclusiveMinimum":0},"employee":{"type":"object","properties":{"curp":{"type":"string","minLength":1},"employeeNumber":{"type":"string","minLength":1},"socialSecurityNumber":{"type":"string","minLength":1},"employmentStartedOn":{"$ref":"#/definitions/__schema11"},"contractType":{"type":"string","enum":["10","99","01","02","03","04","05","06","07","08","09"],"description":"Active SAT payroll contract-type code.","x-exac-sat-catalog":"payroll-contract-types"},"regimeType":{"type":"string","enum":["10","11","12","13","99","02","03","04","05","06","07","08","09"],"description":"Active SAT payroll regime-type code.","x-exac-sat-catalog":"payroll-regime-types"},"paymentFrequency":{"type":"string","enum":["10","99","01","02","03","04","05","06","07","08","09"],"description":"Active SAT payroll payment-frequency code.","x-exac-sat-catalog":"payroll-payment-frequencies"},"stateCode":{"type":"string","enum":["AGU","BCN","BCS","CAM","CHP","CHH","COA","COL","CMX","DUR","GUA","GRO","HID","JAL","MEX","MIC","MOR","NAY","NLE","OAX","PUE","QUE","ROO","SLP","SIN","SON","TAB","TAM","TLA","VER","YUC","ZAC"],"description":"Active SAT federal-entity code.","x-exac-sat-catalog":"federal-entities"},"positionRisk":{"type":"string","enum":["1","2","3","4","5","99"],"description":"Active SAT payroll position-risk code.","x-exac-sat-catalog":"payroll-position-risks"},"integratedDailySalary":{"type":"number","exclusiveMinimum":0}},"required":["curp","employeeNumber","employmentStartedOn","contractType","regimeType","paymentFrequency","stateCode"],"additionalProperties":false},"earnings":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema21"}},"deductions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","minLength":1,"description":"SAT deduction type code"},"amount":{"type":"number","exclusiveMinimum":0}},"required":["type","amount"],"additionalProperties":false}},"otherPayments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["999","001","002","003","004","005","006","007","008","009"],"description":"Active SAT payroll other-payment code.","x-exac-sat-catalog":"payroll-other-payment-types"},"amount":{"type":"number","exclusiveMinimum":0},"employmentSubsidy":{"type":"number","minimum":0}},"required":["type","amount"],"additionalProperties":false}}},"required":["paidOn","employee","earnings"],"additionalProperties":false},"__schema21":{"type":"object","properties":{"type":{"type":"string","enum":["001","002","003","004","005","006","009","010","011","012","013","014","015","019","020","021","022","023","024","025","026","027","028","029","030","031","032","033","034","035","036","037","038","039","044","045","046","047","048","049","050","051","052","053"],"description":"Active SAT payroll earning-type code.","x-exac-sat-catalog":"payroll-earning-types"},"taxableAmount":{"type":"number","minimum":0},"exemptAmount":{"type":"number","minimum":0}},"required":["type","taxableAmount","exemptAmount"],"additionalProperties":false},"__schema22":{"type":"string","const":"payment_complement"},"__schema23":{"type":"string","minLength":1},"__schema24":{"type":"object","properties":{"formCode":{"$ref":"#/definitions/__schema10"},"paidLocalDateTime":{"type":"string","pattern":"^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})(?:\\.(\\d{1,9}))?$"},"documents":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema25"}}},"required":["formCode","documents"],"additionalProperties":false},"__schema25":{"type":"object","properties":{"uuid":{"$ref":"#/definitions/__schema26"},"amount":{"$ref":"#/definitions/__schema27"},"installment":{"$ref":"#/definitions/__schema28"},"previousBalance":{"$ref":"#/definitions/__schema29"},"series":{"$ref":"#/definitions/__schema30"},"folio":{"$ref":"#/definitions/__schema31"},"currency":{"$ref":"#/definitions/__schema32"},"exchangeRate":{"$ref":"#/definitions/__schema33"},"taxes":{"$ref":"#/definitions/__schema34"}},"required":["uuid","amount","installment","previousBalance","taxes"],"additionalProperties":false},"__schema26":{"type":"string","minLength":1},"__schema27":{"type":"number","exclusiveMinimum":0},"__schema28":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"1-based payment sequence"},"__schema29":{"type":"number","exclusiveMinimum":0,"description":"Balance before payment; then use prior remaining balance"},"__schema30":{"type":"string"},"__schema31":{"type":"string"},"__schema32":{"type":"string","minLength":3,"maxLength":3},"__schema33":{"type":"number","exclusiveMinimum":0},"__schema34":{"anyOf":[{"$ref":"#/definitions/__schema35"},{"$ref":"#/definitions/__schema36"}],"description":"Use auto for known CFDIs; otherwise send taxObject and rows"},"__schema35":{"type":"string","const":"auto","description":"Let Exac calculate payment-level taxes from a related CFDI already known to the organization"},"__schema36":{"type":"object","properties":{"taxObject":{"$ref":"#/definitions/__schema37"},"entries":{"$ref":"#/definitions/__schema38"}},"required":["taxObject","entries"],"additionalProperties":false,"description":"Taxes for an external CFDI Exac cannot inspect"},"__schema37":{"type":"string","enum":["01","02","03","04","05","06","07","08"],"description":"SAT ObjetoImpDR from the related CFDI"},"__schema38":{"type":"array","items":{"$ref":"#/definitions/__schema39"},"description":"Payment-level tax rows from the related CFDI"},"__schema39":{"type":"object","properties":{"base":{"$ref":"#/definitions/__schema40"},"type":{"$ref":"#/definitions/__schema41"},"rate":{"$ref":"#/definitions/__schema42"},"factor":{"$ref":"#/definitions/__schema43"},"withholding":{"$ref":"#/definitions/__schema44"}},"required":["base","type","rate"],"additionalProperties":false},"__schema40":{"type":"number","minimum":0},"__schema41":{"type":"string","enum":["IVA","ISR","IEPS"]},"__schema42":{"type":"number","minimum":0},"__schema43":{"type":"string","enum":["Tasa","Cuota","Exento"]},"__schema44":{"type":"boolean"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^cfdi:.+$"},"kind":{"type":"string","enum":["income","credit_note","transfer","payroll","payment_complement"]},"status":{"type":"string","const":"draft"}},"required":["documentRef","kind","status"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"cfdi","order":30,"permissions":["invoices:manage"]}},{"name":"update_cfdi_draft","description":"Fully replace the contents of an existing CFDI draft. The semantic kind must match the draft; changing fiscal kind requires archiving the old draft and creating a new draft.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"oneOf":[{"type":"object","properties":{"pdfCustomSection":{"$ref":"#/definitions/__schema0"},"currency":{"$ref":"#/definitions/__schema1"},"documentRef":{"$ref":"#/definitions/__schema2"},"customerId":{"$ref":"#/definitions/__schema3"},"items":{"$ref":"#/definitions/__schema4"},"kind":{"$ref":"#/definitions/__schema8"},"cfdiUse":{"$ref":"#/definitions/__schema9"},"payment":{"$ref":"#/definitions/__schema10"}},"required":["documentRef","customerId","items","kind","cfdiUse","payment"],"additionalProperties":false,"title":"CFDI I · income"},{"type":"object","properties":{"pdfCustomSection":{"$ref":"#/definitions/__schema0"},"currency":{"$ref":"#/definitions/__schema1"},"documentRef":{"$ref":"#/definitions/__schema2"},"customerId":{"$ref":"#/definitions/__schema3"},"items":{"$ref":"#/definitions/__schema4"},"kind":{"$ref":"#/definitions/__schema13"},"formCode":{"$ref":"#/definitions/__schema11"},"methodCode":{"$ref":"#/definitions/__schema14"},"relatedDocuments":{"$ref":"#/definitions/__schema15"}},"required":["documentRef","customerId","items","kind","formCode","relatedDocuments"],"additionalProperties":false,"title":"CFDI E · credit_note"},{"type":"object","properties":{"pdfCustomSection":{"$ref":"#/definitions/__schema0"},"currency":{"$ref":"#/definitions/__schema1"},"documentRef":{"$ref":"#/definitions/__schema2"},"customerId":{"$ref":"#/definitions/__schema3"},"items":{"$ref":"#/definitions/__schema4"},"kind":{"$ref":"#/definitions/__schema18"}},"required":["documentRef","customerId","items","kind"],"additionalProperties":false,"title":"CFDI T · transfer"},{"type":"object","properties":{"pdfCustomSection":{"$ref":"#/definitions/__schema0"},"currency":{"$ref":"#/definitions/__schema1"},"documentRef":{"$ref":"#/definitions/__schema2"},"kind":{"$ref":"#/definitions/__schema19"},"employeeId":{"$ref":"#/definitions/__schema20"},"payroll":{"$ref":"#/definitions/__schema21"}},"required":["documentRef","kind","employeeId","payroll"],"additionalProperties":false,"title":"CFDI N · payroll"},{"type":"object","properties":{"pdfCustomSection":{"$ref":"#/definitions/__schema0"},"documentRef":{"$ref":"#/definitions/__schema2"},"kind":{"$ref":"#/definitions/__schema23"},"customerId":{"$ref":"#/definitions/__schema24"},"payment":{"$ref":"#/definitions/__schema25"}},"required":["documentRef","kind","customerId","payment"],"additionalProperties":false,"title":"CFDI P · payment_complement"}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string"},"__schema1":{"type":"string","minLength":3,"maxLength":3},"__schema2":{"type":"string","pattern":"^cfdi:","description":"CFDI draft returned by search_documents"},"__schema3":{"type":"string","minLength":1},"__schema4":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema5"}},"__schema5":{"oneOf":[{"$ref":"#/definitions/__schema6"},{"$ref":"#/definitions/__schema7"}]},"__schema6":{"type":"object","properties":{"kind":{"type":"string","const":"product"},"productId":{"type":"string","minLength":1,"description":"Existing Exac product ID"},"quantity":{"type":"number","exclusiveMinimum":0},"unitPrice":{"type":"number","minimum":0,"description":"Unit price in pesos"},"discount":{"type":"number","minimum":0},"taxIncluded":{"type":"boolean"}},"required":["kind","productId","quantity","unitPrice"],"additionalProperties":false},"__schema7":{"type":"object","properties":{"kind":{"type":"string","const":"custom"},"description":{"type":"string","minLength":1},"quantity":{"type":"number","exclusiveMinimum":0},"unitPrice":{"type":"number","minimum":0,"description":"Unit price in pesos"},"satProductCode":{"type":"string","minLength":1,"description":"SAT product/service code"},"satUnitCode":{"type":"string","minLength":1,"description":"SAT unit code"},"discount":{"type":"number","minimum":0},"taxIncluded":{"type":"boolean"},"taxRate":{"type":"number","minimum":0,"maximum":1},"taxability":{"type":"string","enum":["standard","zero","exempt"]}},"required":["kind","description","quantity","unitPrice","satProductCode","satUnitCode"],"additionalProperties":false},"__schema8":{"type":"string","const":"income"},"__schema9":{"type":"string","enum":["G01","D06","I07","I06","I01","I05","D09","G02","D04","I04","I03","D08","G03","D03","D02","D01","D05","I02","CN01","I08","CP01","D10","D07","S01"],"description":"Active SAT CFDI-use code.","x-exac-sat-catalog":"cfdi-uses"},"__schema10":{"oneOf":[{"type":"object","properties":{"timing":{"type":"string","const":"single_payment"},"formCode":{"$ref":"#/definitions/__schema11"},"conditions":{"type":"string","maxLength":1000}},"required":["timing","formCode"],"additionalProperties":false},{"type":"object","properties":{"timing":{"type":"string","const":"deferred_or_installments"},"formCode":{"type":"string","const":"99"},"dueDate":{"description":"Calendar date in YYYY-MM-DD format","allOf":[{"$ref":"#/definitions/__schema12"}]},"settlementTerms":{"type":"object","properties":{"installmentCount":{"type":"integer","minimum":1,"maximum":60},"firstDue":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"transaction_date"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"months_after_transaction"},"months":{"type":"integer","minimum":1,"maximum":60}},"required":["kind","months"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"fixed_date"},"date":{"type":"string"}},"required":["kind","date"],"additionalProperties":false}]},"recurrence":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"anchor_day"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"day_of_month"},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["kind","day"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"last_day"}},"required":["kind"],"additionalProperties":false}]}},"required":["installmentCount","firstDue","recurrence"],"additionalProperties":false},"conditions":{"type":"string","maxLength":1000}},"required":["timing","formCode"],"additionalProperties":false}]},"__schema11":{"type":"string","enum":["12","13","14","15","17","23","24","25","26","27","28","29","30","31","99","02","06","01","05","04","03","08"],"description":"Active SAT payment-form code.","x-exac-sat-catalog":"payment-forms"},"__schema12":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"__schema13":{"type":"string","const":"credit_note"},"__schema14":{"type":"string","enum":["PPD","PUE"],"description":"Active SAT payment-method code. Defaults to PUE when omitted.","x-exac-sat-catalog":"payment-methods"},"__schema15":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema16"}},"__schema16":{"type":"object","properties":{"relationship":{"type":"string","enum":["07","03","06","01","02","04","05"],"description":"Active SAT CFDI relationship-type code.","x-exac-sat-catalog":"relationship-types"},"documents":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema17"},"description":"Related CFDI UUIDs"}},"required":["relationship","documents"],"additionalProperties":false},"__schema17":{"type":"string","minLength":1},"__schema18":{"type":"string","const":"transfer"},"__schema19":{"type":"string","const":"payroll"},"__schema20":{"type":"string","minLength":1},"__schema21":{"type":"object","properties":{"paidOn":{"$ref":"#/definitions/__schema12"},"periodStartedOn":{"allOf":[{"$ref":"#/definitions/__schema12"}]},"periodEndedOn":{"allOf":[{"$ref":"#/definitions/__schema12"}]},"paidDays":{"type":"number","exclusiveMinimum":0},"employee":{"type":"object","properties":{"curp":{"type":"string","minLength":1},"employeeNumber":{"type":"string","minLength":1},"socialSecurityNumber":{"type":"string","minLength":1},"employmentStartedOn":{"$ref":"#/definitions/__schema12"},"contractType":{"type":"string","enum":["10","99","01","02","03","04","05","06","07","08","09"],"description":"Active SAT payroll contract-type code.","x-exac-sat-catalog":"payroll-contract-types"},"regimeType":{"type":"string","enum":["10","11","12","13","99","02","03","04","05","06","07","08","09"],"description":"Active SAT payroll regime-type code.","x-exac-sat-catalog":"payroll-regime-types"},"paymentFrequency":{"type":"string","enum":["10","99","01","02","03","04","05","06","07","08","09"],"description":"Active SAT payroll payment-frequency code.","x-exac-sat-catalog":"payroll-payment-frequencies"},"stateCode":{"type":"string","enum":["AGU","BCN","BCS","CAM","CHP","CHH","COA","COL","CMX","DUR","GUA","GRO","HID","JAL","MEX","MIC","MOR","NAY","NLE","OAX","PUE","QUE","ROO","SLP","SIN","SON","TAB","TAM","TLA","VER","YUC","ZAC"],"description":"Active SAT federal-entity code.","x-exac-sat-catalog":"federal-entities"},"positionRisk":{"type":"string","enum":["1","2","3","4","5","99"],"description":"Active SAT payroll position-risk code.","x-exac-sat-catalog":"payroll-position-risks"},"integratedDailySalary":{"type":"number","exclusiveMinimum":0}},"required":["curp","employeeNumber","employmentStartedOn","contractType","regimeType","paymentFrequency","stateCode"],"additionalProperties":false},"earnings":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema22"}},"deductions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","minLength":1,"description":"SAT deduction type code"},"amount":{"type":"number","exclusiveMinimum":0}},"required":["type","amount"],"additionalProperties":false}},"otherPayments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["999","001","002","003","004","005","006","007","008","009"],"description":"Active SAT payroll other-payment code.","x-exac-sat-catalog":"payroll-other-payment-types"},"amount":{"type":"number","exclusiveMinimum":0},"employmentSubsidy":{"type":"number","minimum":0}},"required":["type","amount"],"additionalProperties":false}}},"required":["paidOn","employee","earnings"],"additionalProperties":false},"__schema22":{"type":"object","properties":{"type":{"type":"string","enum":["001","002","003","004","005","006","009","010","011","012","013","014","015","019","020","021","022","023","024","025","026","027","028","029","030","031","032","033","034","035","036","037","038","039","044","045","046","047","048","049","050","051","052","053"],"description":"Active SAT payroll earning-type code.","x-exac-sat-catalog":"payroll-earning-types"},"taxableAmount":{"type":"number","minimum":0},"exemptAmount":{"type":"number","minimum":0}},"required":["type","taxableAmount","exemptAmount"],"additionalProperties":false},"__schema23":{"type":"string","const":"payment_complement"},"__schema24":{"type":"string","minLength":1},"__schema25":{"type":"object","properties":{"formCode":{"$ref":"#/definitions/__schema11"},"paidLocalDateTime":{"type":"string","pattern":"^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})(?:\\.(\\d{1,9}))?$"},"documents":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema26"}}},"required":["formCode","documents"],"additionalProperties":false},"__schema26":{"type":"object","properties":{"uuid":{"$ref":"#/definitions/__schema27"},"amount":{"$ref":"#/definitions/__schema28"},"installment":{"$ref":"#/definitions/__schema29"},"previousBalance":{"$ref":"#/definitions/__schema30"},"series":{"$ref":"#/definitions/__schema31"},"folio":{"$ref":"#/definitions/__schema32"},"currency":{"$ref":"#/definitions/__schema33"},"exchangeRate":{"$ref":"#/definitions/__schema34"},"taxes":{"$ref":"#/definitions/__schema35"}},"required":["uuid","amount","installment","previousBalance","taxes"],"additionalProperties":false},"__schema27":{"type":"string","minLength":1},"__schema28":{"type":"number","exclusiveMinimum":0},"__schema29":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"1-based payment sequence"},"__schema30":{"type":"number","exclusiveMinimum":0,"description":"Balance before payment; then use prior remaining balance"},"__schema31":{"type":"string"},"__schema32":{"type":"string"},"__schema33":{"type":"string","minLength":3,"maxLength":3},"__schema34":{"type":"number","exclusiveMinimum":0},"__schema35":{"anyOf":[{"$ref":"#/definitions/__schema36"},{"$ref":"#/definitions/__schema37"}],"description":"Use auto for known CFDIs; otherwise send taxObject and rows"},"__schema36":{"type":"string","const":"auto","description":"Let Exac calculate payment-level taxes from a related CFDI already known to the organization"},"__schema37":{"type":"object","properties":{"taxObject":{"$ref":"#/definitions/__schema38"},"entries":{"$ref":"#/definitions/__schema39"}},"required":["taxObject","entries"],"additionalProperties":false,"description":"Taxes for an external CFDI Exac cannot inspect"},"__schema38":{"type":"string","enum":["01","02","03","04","05","06","07","08"],"description":"SAT ObjetoImpDR from the related CFDI"},"__schema39":{"type":"array","items":{"$ref":"#/definitions/__schema40"},"description":"Payment-level tax rows from the related CFDI"},"__schema40":{"type":"object","properties":{"base":{"$ref":"#/definitions/__schema41"},"type":{"$ref":"#/definitions/__schema42"},"rate":{"$ref":"#/definitions/__schema43"},"factor":{"$ref":"#/definitions/__schema44"},"withholding":{"$ref":"#/definitions/__schema45"}},"required":["base","type","rate"],"additionalProperties":false},"__schema41":{"type":"number","minimum":0},"__schema42":{"type":"string","enum":["IVA","ISR","IEPS"]},"__schema43":{"type":"number","minimum":0},"__schema44":{"type":"string","enum":["Tasa","Cuota","Exento"]},"__schema45":{"type":"boolean"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^(cfdi|withholding|sales_receipt|quote|expense|declaration|tax_compliance_opinion|sales_receipt_refund):.+$"},"status":{"type":"string","enum":["draft","valid","canceled"]}},"required":["documentRef","status"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"cfdi","order":40,"permissions":["invoices:manage"]}},{"name":"stamp_cfdi","description":"Irreversibly stamp an existing CFDI draft. Review the draft first with get_document. Safe retries require reusing the same idempotencyKey.","inputSchema":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^cfdi:","description":"CFDI documentRef returned by search_documents"},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"emissionDate":{"description":"Optional SAT-valid emission timestamp to apply while stamping the draft","allOf":[{"$ref":"#/definitions/__schema0"}]}},"required":["documentRef","idempotencyKey"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^cfdi:.+$"},"status":{"type":"string","const":"valid"},"uuid":{"type":"string"},"stampedLocalDateTime":{"type":"string","pattern":"^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})(?:\\.(\\d{1,9}))?$"}},"required":["documentRef","status","uuid"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"cfdi","order":50,"permissions":["invoices:manage"]}},{"name":"refresh_cfdi_status","description":"Consult SAT directly for the current status of a stamped CFDI and reconcile the local document state. This requires verification data captured from its XML.","inputSchema":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^cfdi:","description":"Stamped CFDI documentRef"},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."}},"required":["documentRef","idempotencyKey"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"source":{"type":"string","enum":["webhook","sat_query","sat_bulk"]},"documentStatus":{"type":"string","enum":["valid","canceled","not_found"]},"cancellability":{"type":"string","enum":["unknown","not_cancellable","without_acceptance","with_acceptance"]},"cancellation":{"oneOf":[{"type":"object","properties":{"state":{"type":"string","const":"unchanged"}},"required":["state"],"additionalProperties":false},{"type":"object","properties":{"state":{"type":"string","const":"none"}},"required":["state"],"additionalProperties":false},{"type":"object","properties":{"state":{"type":"string","const":"pending"},"phase":{"type":"string","enum":["requested","verifying"]}},"required":["state","phase"],"additionalProperties":false},{"type":"object","properties":{"state":{"type":"string","const":"rejected"}},"required":["state"],"additionalProperties":false},{"type":"object","properties":{"state":{"type":"string","const":"expired"}},"required":["state"],"additionalProperties":false},{"type":"object","properties":{"state":{"type":"string","const":"completed"},"resolution":{"type":"string","enum":["accepted","without_acceptance","timeout","unknown"]}},"required":["state","resolution"],"additionalProperties":false}]},"observedAt":{"$ref":"#/definitions/__schema0"},"cancellationDate":{"allOf":[{"$ref":"#/definitions/__schema0"}]}},"required":["source","documentStatus","cancellability","cancellation","observedAt"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","format":"date-time"}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"cfdi","order":60,"permissions":["invoices:manage"]}},{"name":"get_fiscal_series","description":"Get the organization fiscal series and their development and production counters.","inputSchema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["preparing","ready","attention_required"]},"initializedAt":{"allOf":[{"$ref":"#/definitions/__schema0"}]},"lastVerifiedAt":{"allOf":[{"$ref":"#/definitions/__schema0"}]},"series":{"type":"array","items":{"type":"object","properties":{"seriesId":{"type":"string","minLength":1},"code":{"type":"string"},"nextFolioProduction":{"$ref":"#/definitions/__schema1"},"nextFolioDevelopment":{"$ref":"#/definitions/__schema1"},"status":{"type":"string","enum":["active","inactive"]},"updatedAt":{"$ref":"#/definitions/__schema0"}},"required":["seriesId","code","nextFolioProduction","nextFolioDevelopment","status","updatedAt"],"additionalProperties":false}}},"required":["status","series"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","format":"date-time"},"__schema1":{"type":"integer","minimum":1,"maximum":9007199254740991}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"setup","order":60,"permissions":["settings:read"]}},{"name":"update_fiscal_series","description":"Edit an existing fiscal series code and its development and production counters.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"seriesId":{"type":"string","minLength":1},"code":{"type":"string","minLength":1,"maxLength":25,"pattern":"^[A-Za-z0-9]+$"},"nextFolioProduction":{"$ref":"#/definitions/__schema0"},"nextFolioDevelopment":{"$ref":"#/definitions/__schema0"}},"required":["idempotencyKey","seriesId","code","nextFolioProduction","nextFolioDevelopment"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"integer","minimum":1,"maximum":9007199254740991}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"seriesId":{"type":"string","minLength":1},"code":{"type":"string"},"nextFolioProduction":{"$ref":"#/definitions/__schema0"},"nextFolioDevelopment":{"$ref":"#/definitions/__schema0"},"status":{"type":"string","enum":["active","inactive"]},"updatedAt":{"type":"string","format":"date-time"}},"required":["seriesId","code","nextFolioProduction","nextFolioDevelopment","status","updatedAt"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"integer","minimum":1,"maximum":9007199254740991}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"setup","order":70,"permissions":["settings:update"]}},{"name":"get_cfdi_summary","description":"Summarize CFDI activity for a month range: recognized income, recognized expenses, payroll paid, payroll received, balance, and top contributors. Every payroll contributor has a paid or received direction. Uses CFDI aggregates only. It excludes receipt/POS sales and is never a source for taxes paid or owed.","inputSchema":{"type":"object","properties":{"monthFrom":{"description":"First included month in YYYY-MM; defaults to 2020-01","allOf":[{"$ref":"#/definitions/__schema0"}]},"monthTo":{"description":"Last included month in YYYY-MM; defaults to current month","allOf":[{"$ref":"#/definitions/__schema1"}]},"contributorLimit":{"description":"Top contributors per category; defaults to 5","allOf":[{"$ref":"#/definitions/__schema2"}]}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string"},"__schema1":{"type":"string"},"__schema2":{"type":"integer","minimum":1,"maximum":10}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"source":{"type":"string","const":"cfdi_activity"},"currency":{"type":"string","const":"MXN"},"period":{"type":"object","properties":{"monthFrom":{"$ref":"#/definitions/__schema0"},"monthTo":{"$ref":"#/definitions/__schema0"}},"required":["monthFrom","monthTo"],"additionalProperties":false},"accountingBasis":{"type":"string","enum":["cash","accrual"]},"receiptSalesIncluded":{"type":"boolean","const":false},"totals":{"type":"object","properties":{"recognizedIncome":{"type":"number"},"recognizedExpenses":{"type":"number"},"payrollPaid":{"type":"number"},"payrollReceived":{"type":"number"},"balance":{"type":"number"},"payrollIncludedInBalance":{"type":"boolean","const":false}},"required":["recognizedIncome","recognizedExpenses","payrollPaid","payrollReceived","balance","payrollIncludedInBalance"],"additionalProperties":false},"contributors":{"type":"object","properties":{"source":{"type":"string","const":"cfdi_activity"},"income":{"type":"array","items":{"$ref":"#/definitions/__schema1"}},"expenses":{"type":"array","items":{"$ref":"#/definitions/__schema1"}},"payroll":{"type":"array","items":{"type":"object","properties":{"name":{"$ref":"#/definitions/__schema2"},"amount":{"$ref":"#/definitions/__schema3"},"isOther":{"$ref":"#/definitions/__schema4"},"direction":{"type":"string","enum":["paid","received"]}},"required":["name","amount","isOther","direction"],"additionalProperties":false}}},"required":["source","income","expenses","payroll"],"additionalProperties":false}},"required":["source","currency","period","accountingBasis","receiptSalesIncluded","totals","contributors"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"__schema1":{"type":"object","properties":{"name":{"$ref":"#/definitions/__schema2"},"amount":{"$ref":"#/definitions/__schema3"},"isOther":{"$ref":"#/definitions/__schema4"}},"required":["name","amount","isOther"],"additionalProperties":false},"__schema2":{"type":"string"},"__schema3":{"type":"number"},"__schema4":{"type":"boolean"}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"reports","order":10,"permissions":["analytics:read"]}},{"name":"get_sales_receipt_summary","description":"Summarize sales recorded as Exac receipts for one business day. Use this for 'how much did I sell?'. It includes receipts later invoiced and receipts never invoiced, and never adds CFDI totals separately.","inputSchema":{"type":"object","properties":{"date":{"description":"Business date in YYYY-MM-DD; defaults to the org's today","allOf":[{"$ref":"#/definitions/__schema0"}]},"activityLimit":{"description":"Top customers, products, and locations; defaults to 4","allOf":[{"$ref":"#/definitions/__schema1"}]}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string"},"__schema1":{"type":"integer","minimum":1,"maximum":10}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"source":{"type":"string","const":"sales_receipts"},"currency":{"type":"string","const":"MXN"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"includesInvoicedReceipts":{"type":"boolean","const":true},"cfdiTotalsIncluded":{"type":"boolean","const":false},"totals":{"type":"object","properties":{"netSales":{"type":"number"},"receiptCount":{"type":"number"}},"required":["netSales","receiptCount"],"additionalProperties":false},"byPaymentMethod":{"type":"array","items":{"type":"object","properties":{"paymentMethod":{"type":"string","enum":["cash","card","transfer","credit","other"]},"netSales":{"type":"number"},"share":{"type":"number"}},"required":["paymentMethod","netSales","share"],"additionalProperties":false}},"top":{"type":"object","properties":{"customers":{"type":"array","items":{"$ref":"#/definitions/__schema0"}},"products":{"type":"array","items":{"$ref":"#/definitions/__schema0"}},"locations":{"type":"array","items":{"$ref":"#/definitions/__schema0"}}},"required":["customers","products","locations"],"additionalProperties":false}},"required":["source","currency","date","includesInvoicedReceipts","cfdiTotalsIncluded","totals","byPaymentMethod","top"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"object","properties":{"name":{"type":"string"},"amount":{"type":"number"},"quantity":{"type":"number"},"receiptCount":{"type":"number"},"share":{"type":"number"}},"required":["name","amount","quantity","receiptCount","share"],"additionalProperties":false}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"reports","order":20,"permissions":["analytics:read"]}},{"name":"get_expense_cash_summary","description":"Summarize manual operational cash outflows for one business day. It includes paid manual expenses and payments allocated to manual credit expenses. It excludes received CFDI invoices and unpaid manual expenses. Historical coverage is forward-only until a backfill is intentionally run.","inputSchema":{"type":"object","properties":{"date":{"description":"Business date in YYYY-MM-DD; defaults to the org's today","allOf":[{"$ref":"#/definitions/__schema0"}]},"activityLimit":{"description":"Top suppliers, categories, and locations; defaults to 4","allOf":[{"$ref":"#/definitions/__schema1"}]}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string"},"__schema1":{"type":"integer","minimum":1,"maximum":10}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"source":{"type":"string","const":"cash_expenses"},"currency":{"type":"string","const":"MXN"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"historicalCoverage":{"type":"string","const":"forward_only"},"accountingBasis":{"type":"string","const":"cash"},"totals":{"type":"object","properties":{"cashOutflow":{"type":"number"},"movementCount":{"type":"number"},"classified":{"type":"number"},"unclassified":{"type":"number"},"unallocated":{"type":"number"}},"required":["cashOutflow","movementCount","classified","unclassified","unallocated"],"additionalProperties":false},"bySource":{"type":"array","items":{"$ref":"#/definitions/__schema0"}},"byPaymentMethod":{"type":"array","items":{"$ref":"#/definitions/__schema0"}},"top":{"type":"object","properties":{"suppliers":{"type":"array","items":{"$ref":"#/definitions/__schema1"}},"categories":{"type":"array","items":{"$ref":"#/definitions/__schema1"}},"locations":{"type":"array","items":{"$ref":"#/definitions/__schema1"}}},"required":["suppliers","categories","locations"],"additionalProperties":false}},"required":["source","currency","date","historicalCoverage","accountingBasis","totals","bySource","byPaymentMethod","top"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"object","properties":{"key":{"type":"string"},"amount":{"type":"number"},"share":{"type":"number"}},"required":["key","amount","share"],"additionalProperties":false},"__schema1":{"type":"object","properties":{"name":{"type":"string"},"amount":{"type":"number"},"movementCount":{"type":"number"},"share":{"type":"number"}},"required":["name","amount","movementCount","share"],"additionalProperties":false}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"reports","order":30,"permissions":["analytics:read"]}},{"name":"get_cfdi_collection_summary","description":"Summarize gross cash collected through valid sent Type I invoices for one CFDI civil day. PUE invoices are recognized on Fecha and PPD collections on payment-complement FechaPago. PPD parents are never counted as cash, so payment allocations cannot double count them. Historical coverage is forward-only until an intentional backfill.","inputSchema":{"type":"object","properties":{"date":{"description":"CFDI civil date in YYYY-MM-DD; defaults to the org's today","allOf":[{"$ref":"#/definitions/__schema0"}]}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"source":{"type":"string","const":"cfdi_collections"},"currency":{"type":"string","const":"MXN"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"historicalCoverage":{"type":"string","const":"forward_only"},"recognitionBasis":{"type":"string","const":"cash_activity"},"totals":{"type":"object","properties":{"grossCollected":{"type":"number"},"movementCount":{"type":"number"}},"required":["grossCollected","movementCount"],"additionalProperties":false},"byRecognitionSource":{"type":"array","items":{"$ref":"#/definitions/__schema0"}},"byPaymentMethod":{"type":"array","items":{"$ref":"#/definitions/__schema0"}}},"required":["source","currency","date","historicalCoverage","recognitionBasis","totals","byRecognitionSource","byPaymentMethod"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"object","properties":{"key":{"type":"string"},"amount":{"type":"number"},"movementCount":{"type":"number"},"share":{"type":"number"}},"required":["key","amount","movementCount","share"],"additionalProperties":false}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"reports","order":40,"permissions":["analytics:read"]}},{"name":"get_tax_summary","description":"Get authoritative taxes declared, paid, and pending for a fiscal year or month. Tax amounts come only from parsed declarations; CFDI contributor context is informational and never affects tax totals. If declarations are unavailable, tax totals are null rather than estimated.","inputSchema":{"type":"object","properties":{"fiscalYear":{"type":"integer","minimum":2000,"maximum":2100,"description":"Four-digit fiscal year"},"period":{"description":"Optional month number from 1 to 12","allOf":[{"$ref":"#/definitions/__schema0"}]},"contributorLimit":{"description":"Top CFDI contributors in the informational context","allOf":[{"$ref":"#/definitions/__schema1"}]}},"required":["fiscalYear"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"integer","minimum":1,"maximum":12},"__schema1":{"type":"integer","minimum":1,"maximum":10}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"source":{"type":"string","const":"sat_declarations"},"currency":{"type":"string","const":"MXN"},"fiscalYear":{"type":"number"},"selectedPeriod":{"anyOf":[{"type":"number"},{"type":"null"}]},"declarationCoverage":{"type":"string","enum":["none","partial","complete"]},"filedPeriods":{"type":"array","items":{"type":"number"}},"missingPeriods":{"type":"array","items":{"type":"number"}},"totals":{"anyOf":[{"type":"object","properties":{"declaredTaxTotal":{"type":"number"},"paidTaxTotal":{"type":"number"},"pendingTaxTotal":{"type":"number"},"breakdown":{"$ref":"#/definitions/__schema0"}},"required":["declaredTaxTotal","paidTaxTotal","pendingTaxTotal","breakdown"],"additionalProperties":false},{"type":"null"}]},"periods":{"type":"array","items":{"type":"object","properties":{"period":{"type":"number"},"filingCount":{"type":"number"},"declaredTaxTotal":{"type":"number"},"paidTaxTotal":{"type":"number"},"pendingTaxTotal":{"type":"number"},"paymentStatus":{"type":"string","enum":["no_obligation","pending","partially_paid","paid"]},"breakdown":{"$ref":"#/definitions/__schema0"},"withholdingDetails":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"amount":{"type":"number"}},"required":["name","amount"],"additionalProperties":false}}},"required":["period","filingCount","declaredTaxTotal","paidTaxTotal","pendingTaxTotal","paymentStatus","breakdown","withholdingDetails"],"additionalProperties":false}},"cfdiContext":{"anyOf":[{"type":"object","properties":{"usedForTaxAmounts":{"type":"boolean","const":false},"contributors":{"type":"object","properties":{"source":{"type":"string","const":"cfdi_activity"},"income":{"type":"array","items":{"$ref":"#/definitions/__schema1"}},"expenses":{"type":"array","items":{"$ref":"#/definitions/__schema1"}},"payroll":{"type":"array","items":{"type":"object","properties":{"name":{"$ref":"#/definitions/__schema2"},"amount":{"$ref":"#/definitions/__schema3"},"isOther":{"$ref":"#/definitions/__schema4"},"direction":{"type":"string","enum":["paid","received"]}},"required":["name","amount","isOther","direction"],"additionalProperties":false}}},"required":["source","income","expenses","payroll"],"additionalProperties":false}},"required":["usedForTaxAmounts","contributors"],"additionalProperties":false},{"type":"null"}]}},"required":["source","currency","fiscalYear","selectedPeriod","declarationCoverage","filedPeriods","missingPeriods","totals","periods","cfdiContext"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"object","properties":{"isr":{"type":"number"},"iva":{"type":"number"},"withholdings":{"type":"number"},"unclassified":{"type":"number"}},"required":["isr","iva","withholdings","unclassified"],"additionalProperties":false},"__schema1":{"type":"object","properties":{"name":{"$ref":"#/definitions/__schema2"},"amount":{"$ref":"#/definitions/__schema3"},"isOther":{"$ref":"#/definitions/__schema4"}},"required":["name","amount","isOther"],"additionalProperties":false},"__schema2":{"type":"string"},"__schema3":{"type":"number"},"__schema4":{"type":"boolean"}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"reports","order":50,"permissions":["sat:read"]}},{"name":"sync_sat_data","description":"Refresh one SAT source for the active organization. Use documents for CFDIs/withholdings in a date range, declarations for one fiscal year, or compliance_opinion for the latest SAT opinion. This starts external SAT work; read results with search_documents or get_tax_summary.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"oneOf":[{"$ref":"#/definitions/__schema0"},{"$ref":"#/definitions/__schema2"},{"$ref":"#/definitions/__schema3"}],"description":"SAT source to refresh and only the arguments required by that source."}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"object","properties":{"source":{"type":"string","const":"documents"},"dateFrom":{"$ref":"#/definitions/__schema1"},"dateTo":{"$ref":"#/definitions/__schema1"},"kind":{"type":"string","enum":["all","invoices","withholdings"]}},"required":["source","dateFrom","dateTo"],"additionalProperties":false},"__schema1":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"__schema2":{"type":"object","properties":{"source":{"type":"string","const":"declarations"},"fiscalYear":{"type":"integer","minimum":2000,"maximum":2100}},"required":["source","fiscalYear"],"additionalProperties":false},"__schema3":{"type":"object","properties":{"source":{"type":"string","const":"compliance_opinion"}},"required":["source"],"additionalProperties":false}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"oneOf":[{"type":"object","properties":{"source":{"type":"string","const":"documents"},"status":{"type":"string","const":"scheduled"},"scheduled":{"type":"number"}},"required":["source","status","scheduled"],"additionalProperties":false},{"type":"object","properties":{"source":{"type":"string","const":"declarations"},"status":{"type":"string","const":"completed"},"fiscalYear":{"type":"number"},"declarations":{"type":"number"},"paymentsMatched":{"type":"number"},"filesDownloaded":{"type":"number"}},"required":["source","status","fiscalYear","declarations","paymentsMatched","filesDownloaded"],"additionalProperties":false},{"type":"object","properties":{"source":{"type":"string","const":"compliance_opinion"},"status":{"type":"string","const":"scheduled"}},"required":["source","status"],"additionalProperties":false}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"reports","order":60,"permissions":["sat:manage"]}},{"name":"get_accounts","description":"Search receivable/payable accounts, retrieve one account, or list its ledger movements. Use customerId for receivables and supplierId for payables.","inputSchema":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"operation":{"type":"string","const":"search"},"kind":{"type":"string","enum":["receivable","payable"],"description":"receivable is customer debt; payable is debt owed to a supplier"},"query":{"type":"string","minLength":1},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["operation","kind"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"get"},"kind":{"type":"string","const":"receivable"},"customerId":{"type":"string"}},"required":["operation","kind","customerId"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"movements"},"kind":{"type":"string","const":"receivable"},"customerId":{"type":"string"},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["operation","kind","customerId"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"get"},"kind":{"type":"string","const":"payable"},"supplierId":{"type":"string"}},"required":["operation","kind","supplierId"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"movements"},"kind":{"type":"string","const":"payable"},"supplierId":{"type":"string"},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["operation","kind","supplierId"],"additionalProperties":false}]}},"required":["input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"object","properties":{"customerId":{"type":"string"},"customerName":{"type":"string"},"supplierId":{"type":"string"},"supplierName":{"type":"string"},"rfc":{"type":"string"},"operationalBalance":{"type":"number"},"fiscalPpdBalance":{"type":"number"},"totalBalance":{"type":"number"}},"anyOf":[{"required":["customerId","customerName"]},{"required":["supplierId","supplierName"]}],"additionalProperties":true}},"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"}},"required":["accounts","nextCursor","hasMore"],"additionalProperties":false},{"type":"object","properties":{"movements":{"type":"array","items":{"type":"object","properties":{"movementId":{"type":"string"},"entryType":{"type":"string"},"date":{"type":"string","format":"date-time"},"amount":{"type":"number"},"balanceAfter":{"type":"number"},"documentLabel":{"type":"string"}},"required":["movementId","entryType","date","amount","balanceAfter","documentLabel"],"additionalProperties":true}},"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"}},"required":["movements","nextCursor","hasMore"],"additionalProperties":false},{"type":"object","properties":{"customerId":{"type":"string"},"customerName":{"type":"string"},"supplierId":{"type":"string"},"supplierName":{"type":"string"},"rfc":{"type":"string"},"operationalBalance":{"type":"number"},"fiscalPpdBalance":{"type":"number"},"totalBalance":{"type":"number"}},"anyOf":[{"required":["customerId","customerName"]},{"required":["supplierId","supplierName"]}],"additionalProperties":true}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"accounting","order":10,"permissions":{"kind":"variant","selector":"input.kind","variants":{"receivable":{"kind":"all-of","permissions":["receivables:read"]},"payable":{"kind":"all-of","permissions":["payables:read"]}}}}},{"name":"record_payment","description":"Record money received from a customer or paid to a supplier and allocate it to open balances. Use the same idempotencyKey when retrying the exact payment.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"oneOf":[{"type":"object","properties":{"direction":{"type":"string","const":"received"},"customerId":{"type":"string"},"allocations":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema0"}},"paymentForm":{"$ref":"#/definitions/__schema1"},"notes":{"type":"string"}},"required":["direction","customerId","allocations","paymentForm"],"additionalProperties":false},{"type":"object","properties":{"direction":{"type":"string","const":"paid"},"supplierId":{"type":"string"},"allocations":{"minItems":1,"type":"array","items":{"$ref":"#/definitions/__schema2"}},"paymentForm":{"$ref":"#/definitions/__schema1"},"notes":{"type":"string"}},"required":["direction","supplierId","allocations","paymentForm"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^sales_receipt:.+$"},"amount":{"type":"number","exclusiveMinimum":0}},"required":["documentRef","amount"],"additionalProperties":false},"__schema1":{"type":"string","enum":["12","13","14","15","17","23","24","25","26","27","28","29","30","31","99","02","06","01","05","04","03","08"],"description":"Active SAT payment-form code.","x-exac-sat-catalog":"payment-forms"},"__schema2":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^expense:.+$"},"amount":{"type":"number","exclusiveMinimum":0}},"required":["documentRef","amount"],"additionalProperties":false}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"direction":{"type":"string","const":"received"},"paymentId":{"type":"string"},"customerId":{"type":"string","minLength":1},"amount":{"type":"number"},"balance":{"type":"number"},"businessDate":{"type":"string"},"paidAt":{"$ref":"#/definitions/__schema0"},"allocations":{"type":"array","items":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^sales_receipt:.+$"},"amount":{"type":"number"}},"required":["documentRef","amount"],"additionalProperties":false}}},"required":["direction","paymentId","customerId","amount","balance","businessDate","paidAt","allocations"],"additionalProperties":false},{"type":"object","properties":{"direction":{"type":"string","const":"paid"},"paymentId":{"type":"string"},"supplierId":{"type":"string","minLength":1},"amount":{"type":"number"},"balance":{"type":"number"},"businessDate":{"type":"string"},"paidAt":{"$ref":"#/definitions/__schema0"},"allocations":{"type":"array","items":{"type":"object","properties":{"documentRef":{"type":"string","pattern":"^expense:.+$"},"amount":{"type":"number"}},"required":["documentRef","amount"],"additionalProperties":false}}},"required":["direction","paymentId","supplierId","amount","balance","businessDate","paidAt","allocations"],"additionalProperties":false}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"type":"string","format":"date-time"}},"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"accounting","order":20,"permissions":{"kind":"variant","selector":"input.direction","variants":{"received":{"kind":"all-of","permissions":["receivables:manage"]},"paid":{"kind":"all-of","permissions":["payables:manage"]}}}}},{"name":"adjust_account_balance","description":"Correct one receivable or payable balance with an auditable reason. kind selects the account family; balanceType selects an operational document or fiscal PPD balance.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"receivable"},"balanceType":{"type":"string","const":"operational"},"customerId":{"type":"string"},"documentRef":{"type":"string","pattern":"^sales_receipt:.+$"},"targetBalance":{"type":"number","minimum":0},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["kind","balanceType","customerId","documentRef","targetBalance","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"receivable"},"balanceType":{"type":"string","const":"fiscalPpd"},"customerId":{"type":"string"},"documentRef":{"type":"string","pattern":"^cfdi:.+$"},"targetBalance":{"type":"number","minimum":0},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["kind","balanceType","customerId","documentRef","targetBalance","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"payable"},"balanceType":{"type":"string","const":"operational"},"supplierId":{"type":"string"},"documentRef":{"type":"string","pattern":"^expense:.+$"},"targetBalance":{"type":"number","minimum":0},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["kind","balanceType","supplierId","documentRef","targetBalance","reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"payable"},"balanceType":{"type":"string","const":"fiscalPpd"},"supplierId":{"type":"string"},"documentRef":{"type":"string","pattern":"^cfdi:.+$"},"targetBalance":{"type":"number","minimum":0},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["kind","balanceType","supplierId","documentRef","targetBalance","reason"],"additionalProperties":false}]}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"previousBalance":{"type":"number"},"previousDocumentBalance":{"type":"number"},"adjustmentAmount":{"type":"number"},"newBalance":{"type":"number"},"newDocumentBalance":{"type":"number"}},"required":["previousBalance","previousDocumentBalance","adjustmentAmount","newBalance","newDocumentBalance"],"additionalProperties":false},{"type":"object","properties":{"previousBalance":{"type":"number"},"previousDocumentBalance":{"type":"number"},"adjustmentAmount":{"type":"number"},"newBalance":{"type":"number"},"newDocumentBalance":{"type":"number"}},"required":["previousBalance","previousDocumentBalance","adjustmentAmount","newBalance","newDocumentBalance"],"additionalProperties":false}]},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"accounting","order":30,"permissions":{"kind":"variant","selector":"input.kind","variants":{"receivable":{"kind":"all-of","permissions":["receivables:manage"]},"payable":{"kind":"all-of","permissions":["payables:manage"]}}}}},{"name":"reschedule_receivable_plan","description":"Replace the installment schedule for an unpaid receivable plan. Use the same idempotencyKey when retrying the exact schedule change.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"type":"object","properties":{"settlementTerms":{"type":"object","properties":{"installmentCount":{"type":"integer","minimum":1,"maximum":60},"firstDue":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"transaction_date"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"months_after_transaction"},"months":{"type":"integer","minimum":1,"maximum":60}},"required":["kind","months"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"fixed_date"},"date":{"type":"string"}},"required":["kind","date"],"additionalProperties":false}]},"recurrence":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"anchor_day"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"day_of_month"},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["kind","day"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"last_day"}},"required":["kind"],"additionalProperties":false}]}},"required":["installmentCount","firstDue","recurrence"],"additionalProperties":false},"reason":{"type":"string","minLength":3,"maxLength":500},"documentRef":{"type":"string","pattern":"^(cfdi|sales_receipt|quote):.+$"}},"required":["settlementTerms","reason","documentRef"],"additionalProperties":false}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"planId":{"type":"string","minLength":1},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"settlementTerms":{"type":"object","properties":{"installmentCount":{"type":"integer","minimum":1,"maximum":60},"firstDue":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"transaction_date"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"months_after_transaction"},"months":{"type":"integer","minimum":1,"maximum":60}},"required":["kind","months"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"fixed_date"},"date":{"type":"string"}},"required":["kind","date"],"additionalProperties":false}]},"recurrence":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"anchor_day"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"day_of_month"},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["kind","day"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"last_day"}},"required":["kind"],"additionalProperties":false}]}},"required":["installmentCount","firstDue","recurrence"],"additionalProperties":false},"paymentDueDate":{"type":"string"},"installments":{"type":"array","items":{"type":"object","properties":{"sequence":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"dueDate":{"type":"string"},"amount":{"type":"number"}},"required":["sequence","dueDate","amount"],"additionalProperties":false}}},"required":["planId","version","settlementTerms","paymentDueDate","installments"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"accounting","order":40,"permissions":["receivables:manage"]}},{"name":"set_payable_payment_plan","description":"Create or replace the payment plan for a received PPD invoice.","inputSchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":1,"maxLength":200,"description":"Unique retry key for this exact operation. Reuse it only when retrying the same request."},"input":{"type":"object","properties":{"settlementTerms":{"anyOf":[{"type":"object","properties":{"installmentCount":{"type":"integer","minimum":1,"maximum":60},"firstDue":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"transaction_date"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"months_after_transaction"},"months":{"type":"integer","minimum":1,"maximum":60}},"required":["kind","months"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"fixed_date"},"date":{"type":"string"}},"required":["kind","date"],"additionalProperties":false}]},"recurrence":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"anchor_day"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"day_of_month"},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["kind","day"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"last_day"}},"required":["kind"],"additionalProperties":false}]}},"required":["installmentCount","firstDue","recurrence"],"additionalProperties":false},{"type":"null"}]},"supplierId":{"type":"string"},"documentRef":{"type":"string","pattern":"^cfdi:.+$"}},"required":["settlementTerms","supplierId","documentRef"],"additionalProperties":false}},"required":["idempotencyKey","input"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"execution":{"taskSupport":"forbidden"},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"settlementTerms":{"type":"object","properties":{"installmentCount":{"type":"integer","minimum":1,"maximum":60},"firstDue":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"transaction_date"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"months_after_transaction"},"months":{"type":"integer","minimum":1,"maximum":60}},"required":["kind","months"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"fixed_date"},"date":{"type":"string"}},"required":["kind","date"],"additionalProperties":false}]},"recurrence":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"anchor_day"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"day_of_month"},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["kind","day"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"last_day"}},"required":["kind"],"additionalProperties":false}]}},"required":["installmentCount","firstDue","recurrence"],"additionalProperties":false},"paymentDueDate":{"type":"string"},"documentRef":{"type":"string","pattern":"^cfdi:.+$"},"plannedAt":{"type":"string","format":"date-time"}},"required":["documentRef","plannedAt"],"additionalProperties":false},"error":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","forbidden","not_found","method_not_allowed","conflict","idempotency_conflict","operation_in_progress","recovery_required","rate_limited","provider_unavailable","internal"]},"message":{"type":"string"},"details":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAfterSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["code","message"],"additionalProperties":false}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"oneOf":[{"required":["data"]},{"required":["error"]}]},"docs":{"group":"accounting","order":50,"permissions":["payables:manage"]}}]}