@fourier-labs/harbour-contracts 0.88.0 → 0.91.0

package/schema/integration-execute-request.schema.json

@@ -470,8 +470,8 @@
         },
         "documentId": {
           "type": "string",
-          "pattern": "^[A-Za-z0-9_-]{10,128}$",
-          "description": "docs.document.read / docs.document.append / docs.text.replace (0.86.0): the Google Docs document id (the `/document/d/<id>` path segment, or a docs.document.create result's id)."
+          "pattern": "^(?:[A-Za-z0-9_-]{10,128}|[0-9]{1,32})$",
+          "description": "Google Docs document id or Zoho Books document id; each operation restricts its provider format."
         },
         "spreadsheetId": {
           "type": "string",
@@ -524,7 +524,7 @@
           "items": {
             "$ref": "#/definitions/DocsReplacement"
           },
-          "description": "docs.text.replace (0.86.0): the find-and-replace pairs applied over the whole document, 1..64, in order (a mail merge: `{{customer}}` → the name)."
+          "description": "docs.text.replace (0.86.0): the find-and-replace pairs applied over the whole document, 1..64, in order (a mail merge: `{{customer}}` \u2192 the name)."
         },
         "worksheet": {
           "type": "string",
@@ -571,6 +571,76 @@
             "maxLength": 100
           },
           "description": "sheets.spreadsheet.create (0.86.0): the titles of the sheets the new spreadsheet starts with, 1..20; absent creates the one default sheet."
+        },
+        "vendorId": {
+          "type": "string",
+          "pattern": "^[0-9]{1,32}$",
+          "maxLength": 32
+        },
+        "customerId": {
+          "type": "string",
+          "pattern": "^[0-9]{1,32}$",
+          "maxLength": 32
+        },
+        "purchaseOrderId": {
+          "type": "string",
+          "pattern": "^[0-9]{1,32}$",
+          "maxLength": 32
+        },
+        "documentNumber": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "documentDate": {
+          "type": "string",
+          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
+          "maxLength": 10
+        },
+        "referenceNumber": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "lineItems": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 100,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "itemId",
+              "quantity",
+              "rate"
+            ],
+            "properties": {
+              "itemId": {
+                "type": "string",
+                "pattern": "^[0-9]{1,32}$",
+                "maxLength": 32
+              },
+              "quantity": {
+                "type": "string",
+                "pattern": "^[0-9]{1,10}(\\.[0-9]{1,6})?$",
+                "maxLength": 17
+              },
+              "rate": {
+                "type": "string",
+                "pattern": "^[0-9]{1,10}(\\.[0-9]{1,6})?$",
+                "maxLength": 17
+              },
+              "taxId": {
+                "type": "string",
+                "pattern": "^[0-9]{1,32}$",
+                "maxLength": 32
+              },
+              "description": {
+                "type": "string",
+                "maxLength": 2000
+              }
+            }
+          }
         }
       }
     },
@@ -589,7 +659,12 @@
       "items": {
         "type": "object",
         "additionalProperties": {
-          "type": ["string", "number", "boolean", "null"]
+          "type": [
+            "string",
+            "number",
+            "boolean",
+            "null"
+          ]
         },
         "description": "One sample row keyed by column name; each value is a scalar that governance parses by the column's recorded type."
       },
@@ -2201,7 +2276,14 @@
             },
             "required": [
               "documentId"
-            ]
+            ],
+            "properties": {
+              "documentId": {
+                "type": "string",
+                "pattern": "^[A-Za-z0-9_-]{10,128}$",
+                "description": "docs.document.read / docs.document.append / docs.text.replace (0.86.0): the Google Docs document id (the `/document/d/<id>` path segment, or a docs.document.create result's id)."
+              }
+            }
           }
         }
       }
@@ -2264,7 +2346,14 @@
             "required": [
               "documentId",
               "text"
-            ]
+            ],
+            "properties": {
+              "documentId": {
+                "type": "string",
+                "pattern": "^[A-Za-z0-9_-]{10,128}$",
+                "description": "docs.document.read / docs.document.append / docs.text.replace (0.86.0): the Google Docs document id (the `/document/d/<id>` path segment, or a docs.document.create result's id)."
+              }
+            }
           }
         }
       }
@@ -2297,7 +2386,14 @@
             "required": [
               "documentId",
               "replacements"
-            ]
+            ],
+            "properties": {
+              "documentId": {
+                "type": "string",
+                "pattern": "^[A-Za-z0-9_-]{10,128}$",
+                "description": "docs.document.read / docs.document.append / docs.text.replace (0.86.0): the Google Docs document id (the `/document/d/<id>` path segment, or a docs.document.create result's id)."
+              }
+            }
           }
         }
       }
@@ -3344,6 +3440,280 @@
           }
         }
       }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "zohobooks.contact.list"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": true,
+        "x-primary-identity": "user",
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "q",
+                "pageToken"
+              ]
+            }
+          }
+        },
+        "not": {
+          "required": [
+            "idempotencyKey"
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "zohobooks.purchaseorder.list"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": true,
+        "x-primary-identity": "user",
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "vendorId",
+                "pageToken"
+              ]
+            },
+            "required": [
+              "vendorId"
+            ]
+          }
+        },
+        "not": {
+          "required": [
+            "idempotencyKey"
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "zohobooks.purchaseorder.read"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": true,
+        "x-primary-identity": "user",
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "purchaseOrderId"
+              ]
+            },
+            "required": [
+              "purchaseOrderId"
+            ]
+          }
+        },
+        "not": {
+          "required": [
+            "idempotencyKey"
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "zohobooks.bill.create"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": false,
+        "x-primary-identity": "user",
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "vendorId",
+                "documentNumber",
+                "documentDate",
+                "purchaseOrderId",
+                "lineItems"
+              ]
+            },
+            "required": [
+              "vendorId",
+              "documentNumber",
+              "documentDate",
+              "lineItems"
+            ]
+          }
+        },
+        "required": [
+          "idempotencyKey"
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "zohobooks.bill.read"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": true,
+        "x-primary-identity": "user",
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "documentId"
+              ]
+            },
+            "required": [
+              "documentId"
+            ],
+            "properties": {
+              "documentId": {
+                "pattern": "^[0-9]{1,32}$",
+                "maxLength": 32
+              }
+            }
+          }
+        },
+        "not": {
+          "required": [
+            "idempotencyKey"
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "zohobooks.invoice.create"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": false,
+        "x-primary-identity": "user",
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "customerId",
+                "documentNumber",
+                "documentDate",
+                "referenceNumber",
+                "lineItems"
+              ]
+            },
+            "required": [
+              "customerId",
+              "documentDate",
+              "lineItems"
+            ]
+          }
+        },
+        "required": [
+          "idempotencyKey"
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "zohobooks.invoice.read"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": true,
+        "x-primary-identity": "user",
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "documentId"
+              ]
+            },
+            "required": [
+              "documentId"
+            ],
+            "properties": {
+              "documentId": {
+                "pattern": "^[0-9]{1,32}$",
+                "maxLength": 32
+              }
+            }
+          }
+        },
+        "not": {
+          "required": [
+            "idempotencyKey"
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "zohobooks.invoice.pdf"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": true,
+        "x-primary-identity": "user",
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "documentId"
+              ]
+            },
+            "required": [
+              "documentId"
+            ],
+            "properties": {
+              "documentId": {
+                "pattern": "^[0-9]{1,32}$",
+                "maxLength": 32
+              }
+            }
+          }
+        },
+        "not": {
+          "required": [
+            "idempotencyKey"
+          ]
+        }
+      }
     }
   ],
   "definitions": {
@@ -4616,6 +4986,87 @@
         "text": "Thanks, shipped."
       },
       "idempotencyKey": "6f1c2c1e-3a1c-4c3e-9f0e-2b6f7d8a9d15"
+    },
+    {
+      "connection": "company-zohobooks",
+      "operation": "zohobooks.contact.list",
+      "resource": "organization",
+      "input": {}
+    },
+    {
+      "connection": "company-zohobooks",
+      "operation": "zohobooks.purchaseorder.list",
+      "resource": "organization",
+      "input": {
+        "vendorId": "123"
+      }
+    },
+    {
+      "connection": "company-zohobooks",
+      "operation": "zohobooks.purchaseorder.read",
+      "resource": "organization",
+      "input": {
+        "purchaseOrderId": "456"
+      }
+    },
+    {
+      "connection": "company-zohobooks",
+      "operation": "zohobooks.bill.create",
+      "resource": "organization",
+      "input": {
+        "vendorId": "123",
+        "documentNumber": "TEST-BILL-001",
+        "documentDate": "2026-10-23",
+        "lineItems": [
+          {
+            "itemId": "789",
+            "quantity": "10",
+            "rate": "100"
+          }
+        ]
+      },
+      "idempotencyKey": "12345678-1234-1234-1234-123456789012"
+    },
+    {
+      "connection": "company-zohobooks",
+      "operation": "zohobooks.bill.read",
+      "resource": "organization",
+      "input": {
+        "documentId": "456"
+      }
+    },
+    {
+      "connection": "company-zohobooks",
+      "operation": "zohobooks.invoice.create",
+      "resource": "organization",
+      "input": {
+        "customerId": "123",
+        "documentDate": "2026-10-23",
+        "lineItems": [
+          {
+            "itemId": "789",
+            "quantity": "10",
+            "rate": "100"
+          }
+        ]
+      },
+      "idempotencyKey": "12345678-1234-1234-1234-123456789012"
+    },
+    {
+      "connection": "company-zohobooks",
+      "operation": "zohobooks.invoice.read",
+      "resource": "organization",
+      "input": {
+        "documentId": "456"
+      }
+    },
+    {
+      "connection": "company-zohobooks",
+      "operation": "zohobooks.invoice.pdf",
+      "resource": "organization",
+      "input": {
+        "documentId": "456"
+      }
     }
   ]
 }