Xero

Use the @bijection/connectors/xero entrypoint to declare Xero resources.

Availability

This page describes the pinned source package. Published availability is unestablished for this artifact. Source build and package availability.

Resources and modes

Resource	Mode	Description
Invoices and bills	`pull`	If-Modified-Since pages in XML, DELETED as deletion, idempotency-keyed creates
Contacts	`pull`	If-Modified-Since pages in XML, archived included, idempotency-keyed updates

Declare a resource in application code, then bind deployment-specific settings and credentials. See typed resources, connections and source inspection.

Invoices and bills

pull: If-Modified-Since pages in XML, DELETED as deletion, idempotency-keyed creates

The following example matches configuration standard.

import { xero } from "@bijection/connectors/xero";
import { makeFunctionReference } from "bijection/server";

export const invoices = xero.invoices.pull({
  governingRule: makeFunctionReference<"query", any, [null]>("ledger:canWrite"),
  updates: "webhooks",
});

Inferred record types

Resource without an operational record table

The function references identify application policy queries. Implement those policies in your application; the references alone grant no authority.

Configuration: standard

Case: xero/invoices/pull/standard. Connection and resource configuration are declared by this exact case. Credential kind: xero. Keep credential material in the private credential inventory.

Setting	Type	Required	Owner
`tenantId`	string	Yes	Resource binding

Complete configuration contract

{
  "setup": [],
  "resource": {
    "access": {},
    "defaults": {},
    "connector": "xero",
    "output": {
      "kind": "single",
      "collection": "invoices"
    },
    "credential_kind": "xero",
    "connection_fields": [],
    "address": {
      "kind": "fixed",
      "url": "https://api.xero.com"
    }
  },
  "connection_setup": {
    "type": "object",
    "value": {
      "tenantId": {
        "fieldType": {
          "type": "string"
        },
        "optional": false
      }
    }
  },
  "execution": null
}

Native admission analysis is available for this exact declaration. Collection: invoices

Contract	Meaning
Initial	Enumeration of observed records
Changes	Repeated observations of current records
Deletions	Explicit deletion evidence
Resume	No continuation
Gap	Not applicable
Retention	Unspecified

Complete native profile

{
  "movement": {
    "exchanges": {
      "invoicesChanged": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "document",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      },
      "invoicesWalk": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "document",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      }
    },
    "nativeInputLimitBytes": null,
    "steps": [
      {
        "id": "acquire.1",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange invoicesChanged",
          "limitBytes": null
        }
      },
      {
        "id": "acquire.2",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange invoicesWalk",
          "limitBytes": null
        }
      },
      {
        "id": "acquire.3",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "listener changes",
          "limitBytes": null
        }
      },
      {
        "id": "retain.1",
        "inputs": [
          "acquire.1",
          "acquire.2",
          "acquire.3"
        ],
        "action": {
          "operation": "retain",
          "subject": "acquisition evidence",
          "reason": "recovery",
          "release": "acquisition_custody"
        }
      },
      {
        "id": "interpret.1",
        "inputs": [
          "retain.1"
        ],
        "action": {
          "operation": "interpret",
          "subject": "acquired input",
          "produces": "records"
        }
      },
      {
        "id": "materialize.1",
        "inputs": [
          "interpret.1"
        ],
        "action": {
          "operation": "materialize",
          "subject": "source rows",
          "reason": "serving",
          "release": "replacement"
        }
      },
      {
        "id": "publish.1",
        "inputs": [
          "materialize.1"
        ],
        "action": {
          "operation": "publish",
          "subject": "source rows",
          "visibility": "with_acquisition"
        }
      }
    ]
  },
  "initial": "enumeration",
  "changes": "observations",
  "deletions": "explicit_events",
  "resume": "none",
  "retentionMs": null,
  "gap": "not_applicable",
  "limits": {
    "http_response_bytes": "524288"
  },
  "restrictions": [],
  "commands": {
    "create": {
      "target": "invoices",
      "delivery": "idempotent",
      "condition": "unconditional",
      "replayWindowMs": "360000",
      "maxDeliveryHours": "1",
      "providerEnforcedExpiry": false
    }
  }
}

Commands

Command	Target	Condition	Delivery
`create`	invoices	Unconditional	Provider idempotency contract

Commands, occurrences and artifacts

{
  "records": {
    "invoices": {
      "protocol": "record_observation",
      "coverage": "records",
      "consistency": "observations",
      "atomicity": "record",
      "history": "observations",
      "recordRefresh": false,
      "reconciliation": false,
      "notifications": true,
      "snapshotMaxRows": null,
      "profile": {
        "movement": {
          "exchanges": {
            "invoicesChanged": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "document",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            },
            "invoicesWalk": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "document",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            }
          },
          "nativeInputLimitBytes": null,
          "steps": [
            {
              "id": "acquire.1",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange invoicesChanged",
                "limitBytes": null
              }
            },
            {
              "id": "acquire.2",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange invoicesWalk",
                "limitBytes": null
              }
            },
            {
              "id": "acquire.3",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "listener changes",
                "limitBytes": null
              }
            },
            {
              "id": "retain.1",
              "inputs": [
                "acquire.1",
                "acquire.2",
                "acquire.3"
              ],
              "action": {
                "operation": "retain",
                "subject": "acquisition evidence",
                "reason": "recovery",
                "release": "acquisition_custody"
              }
            },
            {
              "id": "interpret.1",
              "inputs": [
                "retain.1"
              ],
              "action": {
                "operation": "interpret",
                "subject": "acquired input",
                "produces": "records"
              }
            },
            {
              "id": "materialize.1",
              "inputs": [
                "interpret.1"
              ],
              "action": {
                "operation": "materialize",
                "subject": "source rows",
                "reason": "serving",
                "release": "replacement"
              }
            },
            {
              "id": "publish.1",
              "inputs": [
                "materialize.1"
              ],
              "action": {
                "operation": "publish",
                "subject": "source rows",
                "visibility": "with_acquisition"
              }
            }
          ]
        },
        "initial": "enumeration",
        "changes": "observations",
        "deletions": "explicit_events",
        "resume": "none",
        "retentionMs": null,
        "gap": "not_applicable",
        "limits": {
          "http_response_bytes": "524288"
        },
        "restrictions": [],
        "commands": {
          "create": {
            "target": "invoices",
            "delivery": "idempotent",
            "condition": "unconditional",
            "replayWindowMs": "360000",
            "maxDeliveryHours": "1",
            "providerEnforcedExpiry": false
          }
        }
      }
    }
  },
  "occurrences": null,
  "artifacts": {
    "raw_archive": false,
    "native_file_transfer_limit_bytes": null,
    "external_versions": false,
    "files": {}
  },
  "commands": {
    "create": {
      "target": "invoices",
      "condition": {
        "kind": "unconditional"
      },
      "delivery": {
        "kind": "idempotent",
        "retention": {
          "kind": "stated",
          "unit": "minutes",
          "value": 6
        },
        "max_delivery_hours": 1,
        "request_expiry": "none"
      }
    }
  }
}

Recorded checks

Requirement	Scope	Evidence	Result
listener-custody-before-ack	{“kind”:“listener”,“collection”:“invoices”}	Native test: integrations/listeners/webhook_delivery_commits_responsibility_before_acknowledging (shared_engine)	Execution result unavailable
listener-duplicate-delivery	{“kind”:“listener”,“collection”:“invoices”}	Native test: integrations/providers/shopify_product_hint_is_deduplicated_and_refused_when_unsigned (shared_engine)	Execution result unavailable
page-publication-recovery	{“kind”:“collection”,“name”:“invoices”}	Native test: integrations/acquisition/acquisition_windows_preserve_sequences_and_restart_fences_old_work (shared_engine)	Execution result unavailable
command-response-lost	{“kind”:“command”,“name”:“create”}	Native test: integrations/listeners/calendar_repair_preserves_accepted_responsibility (shared_engine)	Execution result unavailable
backoff-stated-wait	{“kind”:“connection”}	Native test: integrations/acquisition/backoff_a_stated_wait_defers_the_next_dispatch_and_then_resumes (shared_engine)	Execution result unavailable
budget-shared	{“kind”:“connection”}	Native test: integrations/acquisition/budget_one_bucket_is_spent_by_a_collection_and_by_a_command (shared_engine)	Execution result unavailable
identity-account	{“kind”:“connection”}	Fixture: ./src/connectors/xero/fixtures/identity.json	passed (2026-10-24T21:36:12.547Z)

Hosted qualification: unestablished for this catalog configuration. Installed connections report their own identity, authority and current status.

Configuration: readOnly

Case: xero/invoices/pull/readOnly. Connection and resource configuration are declared by this exact case. Credential kind: xero. Keep credential material in the private credential inventory.

Setting	Type	Required	Owner
`tenantId`	string	Yes	Resource binding

Complete configuration contract

{
  "setup": [],
  "resource": {
    "access": {},
    "defaults": {},
    "connector": "xero",
    "output": {
      "kind": "single",
      "collection": "invoices"
    },
    "credential_kind": "xero",
    "connection_fields": [],
    "address": {
      "kind": "fixed",
      "url": "https://api.xero.com"
    }
  },
  "connection_setup": {
    "type": "object",
    "value": {
      "tenantId": {
        "fieldType": {
          "type": "string"
        },
        "optional": false
      }
    }
  },
  "execution": null
}

Native admission analysis is available for this exact declaration. Collection: invoices

Contract	Meaning
Initial	Enumeration of observed records
Changes	Repeated observations of current records
Deletions	Explicit deletion evidence
Resume	No continuation
Gap	Not applicable
Retention	Unspecified

Complete native profile

{
  "movement": {
    "exchanges": {
      "invoicesChanged": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "document",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      },
      "invoicesWalk": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "document",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      }
    },
    "nativeInputLimitBytes": null,
    "steps": [
      {
        "id": "acquire.1",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange invoicesChanged",
          "limitBytes": null
        }
      },
      {
        "id": "acquire.2",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange invoicesWalk",
          "limitBytes": null
        }
      },
      {
        "id": "retain.1",
        "inputs": [
          "acquire.1",
          "acquire.2"
        ],
        "action": {
          "operation": "retain",
          "subject": "acquisition evidence",
          "reason": "recovery",
          "release": "acquisition_custody"
        }
      },
      {
        "id": "interpret.1",
        "inputs": [
          "retain.1"
        ],
        "action": {
          "operation": "interpret",
          "subject": "acquired input",
          "produces": "records"
        }
      },
      {
        "id": "materialize.1",
        "inputs": [
          "interpret.1"
        ],
        "action": {
          "operation": "materialize",
          "subject": "source rows",
          "reason": "serving",
          "release": "replacement"
        }
      },
      {
        "id": "publish.1",
        "inputs": [
          "materialize.1"
        ],
        "action": {
          "operation": "publish",
          "subject": "source rows",
          "visibility": "with_acquisition"
        }
      }
    ]
  },
  "initial": "enumeration",
  "changes": "observations",
  "deletions": "explicit_events",
  "resume": "none",
  "retentionMs": null,
  "gap": "not_applicable",
  "limits": {
    "http_response_bytes": "524288"
  },
  "restrictions": [],
  "commands": {}
}

Commands, occurrences and artifacts

{
  "records": {
    "invoices": {
      "protocol": "record_observation",
      "coverage": "records",
      "consistency": "observations",
      "atomicity": "record",
      "history": "observations",
      "recordRefresh": false,
      "reconciliation": false,
      "notifications": false,
      "snapshotMaxRows": null,
      "profile": {
        "movement": {
          "exchanges": {
            "invoicesChanged": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "document",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            },
            "invoicesWalk": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "document",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            }
          },
          "nativeInputLimitBytes": null,
          "steps": [
            {
              "id": "acquire.1",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange invoicesChanged",
                "limitBytes": null
              }
            },
            {
              "id": "acquire.2",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange invoicesWalk",
                "limitBytes": null
              }
            },
            {
              "id": "retain.1",
              "inputs": [
                "acquire.1",
                "acquire.2"
              ],
              "action": {
                "operation": "retain",
                "subject": "acquisition evidence",
                "reason": "recovery",
                "release": "acquisition_custody"
              }
            },
            {
              "id": "interpret.1",
              "inputs": [
                "retain.1"
              ],
              "action": {
                "operation": "interpret",
                "subject": "acquired input",
                "produces": "records"
              }
            },
            {
              "id": "materialize.1",
              "inputs": [
                "interpret.1"
              ],
              "action": {
                "operation": "materialize",
                "subject": "source rows",
                "reason": "serving",
                "release": "replacement"
              }
            },
            {
              "id": "publish.1",
              "inputs": [
                "materialize.1"
              ],
              "action": {
                "operation": "publish",
                "subject": "source rows",
                "visibility": "with_acquisition"
              }
            }
          ]
        },
        "initial": "enumeration",
        "changes": "observations",
        "deletions": "explicit_events",
        "resume": "none",
        "retentionMs": null,
        "gap": "not_applicable",
        "limits": {
          "http_response_bytes": "524288"
        },
        "restrictions": [],
        "commands": {}
      }
    }
  },
  "occurrences": null,
  "artifacts": {
    "raw_archive": false,
    "native_file_transfer_limit_bytes": null,
    "external_versions": false,
    "files": {}
  },
  "commands": {}
}

Recorded checks

Requirement	Scope	Evidence	Result
page-publication-recovery	{“kind”:“collection”,“name”:“invoices”}	Native test: integrations/acquisition/acquisition_windows_preserve_sequences_and_restart_fences_old_work (shared_engine)	Execution result unavailable
backoff-stated-wait	{“kind”:“connection”}	Native test: integrations/acquisition/backoff_a_stated_wait_defers_the_next_dispatch_and_then_resumes (shared_engine)	Execution result unavailable
budget-shared	{“kind”:“connection”}	Native test: integrations/acquisition/budget_one_bucket_is_spent_by_a_collection_and_by_a_command (shared_engine)	Execution result unavailable
identity-account	{“kind”:“connection”}	Fixture: ./src/connectors/xero/fixtures/identity.json	passed (2026-10-24T21:36:12.547Z)

Hosted qualification: unestablished for this catalog configuration. Installed connections report their own identity, authority and current status.

Contacts

pull: If-Modified-Since pages in XML, archived included, idempotency-keyed updates

The following example matches configuration standard.

import { xero } from "@bijection/connectors/xero";
import { makeFunctionReference } from "bijection/server";

export const contacts = xero.contacts.pull({
  governingRule: makeFunctionReference<"query", any, [null]>("ledger:canWrite"),
});

Inferred record types

Resource without an operational record table

The function references identify application policy queries. Implement those policies in your application; the references alone grant no authority.

Configuration: standard

Case: xero/contacts/pull/standard. Connection and resource configuration are declared by this exact case. Credential kind: xero. Keep credential material in the private credential inventory.

Setting	Type	Required	Owner
`tenantId`	string	Yes	Resource binding

Complete configuration contract

{
  "setup": [],
  "resource": {
    "access": {},
    "defaults": {},
    "connector": "xero",
    "output": {
      "kind": "single",
      "collection": "contacts"
    },
    "credential_kind": "xero",
    "connection_fields": [],
    "address": {
      "kind": "fixed",
      "url": "https://api.xero.com"
    }
  },
  "connection_setup": {
    "type": "object",
    "value": {
      "tenantId": {
        "fieldType": {
          "type": "string"
        },
        "optional": false
      }
    }
  },
  "execution": null
}

Native admission analysis is available for this exact declaration. Collection: contacts

Contract	Meaning
Initial	Enumeration of observed records
Changes	Repeated observations of current records
Deletions	Deletion detection unsupported
Resume	No continuation
Gap	Not applicable
Retention	Unspecified

Complete native profile

{
  "movement": {
    "exchanges": {
      "contactsChanged": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "document",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      },
      "contactsWalk": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "document",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      }
    },
    "nativeInputLimitBytes": null,
    "steps": [
      {
        "id": "acquire.1",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange contactsChanged",
          "limitBytes": null
        }
      },
      {
        "id": "acquire.2",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange contactsWalk",
          "limitBytes": null
        }
      },
      {
        "id": "retain.1",
        "inputs": [
          "acquire.1",
          "acquire.2"
        ],
        "action": {
          "operation": "retain",
          "subject": "acquisition evidence",
          "reason": "recovery",
          "release": "acquisition_custody"
        }
      },
      {
        "id": "interpret.1",
        "inputs": [
          "retain.1"
        ],
        "action": {
          "operation": "interpret",
          "subject": "acquired input",
          "produces": "records"
        }
      },
      {
        "id": "materialize.1",
        "inputs": [
          "interpret.1"
        ],
        "action": {
          "operation": "materialize",
          "subject": "source rows",
          "reason": "serving",
          "release": "replacement"
        }
      },
      {
        "id": "publish.1",
        "inputs": [
          "materialize.1"
        ],
        "action": {
          "operation": "publish",
          "subject": "source rows",
          "visibility": "with_acquisition"
        }
      }
    ]
  },
  "initial": "enumeration",
  "changes": "observations",
  "deletions": "unsupported",
  "resume": "none",
  "retentionMs": null,
  "gap": "not_applicable",
  "limits": {
    "http_response_bytes": "524288"
  },
  "restrictions": [],
  "commands": {
    "update": {
      "target": "contacts",
      "delivery": "idempotent",
      "condition": "unconditional",
      "replayWindowMs": "360000",
      "maxDeliveryHours": "1",
      "providerEnforcedExpiry": false
    }
  }
}

Commands

Command	Target	Condition	Delivery
`update`	contacts	Unconditional	Provider idempotency contract

Commands, occurrences and artifacts

{
  "records": {
    "contacts": {
      "protocol": "record_observation",
      "coverage": "records",
      "consistency": "observations",
      "atomicity": "record",
      "history": "observations",
      "recordRefresh": false,
      "reconciliation": false,
      "notifications": false,
      "snapshotMaxRows": null,
      "profile": {
        "movement": {
          "exchanges": {
            "contactsChanged": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "document",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            },
            "contactsWalk": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "document",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            }
          },
          "nativeInputLimitBytes": null,
          "steps": [
            {
              "id": "acquire.1",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange contactsChanged",
                "limitBytes": null
              }
            },
            {
              "id": "acquire.2",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange contactsWalk",
                "limitBytes": null
              }
            },
            {
              "id": "retain.1",
              "inputs": [
                "acquire.1",
                "acquire.2"
              ],
              "action": {
                "operation": "retain",
                "subject": "acquisition evidence",
                "reason": "recovery",
                "release": "acquisition_custody"
              }
            },
            {
              "id": "interpret.1",
              "inputs": [
                "retain.1"
              ],
              "action": {
                "operation": "interpret",
                "subject": "acquired input",
                "produces": "records"
              }
            },
            {
              "id": "materialize.1",
              "inputs": [
                "interpret.1"
              ],
              "action": {
                "operation": "materialize",
                "subject": "source rows",
                "reason": "serving",
                "release": "replacement"
              }
            },
            {
              "id": "publish.1",
              "inputs": [
                "materialize.1"
              ],
              "action": {
                "operation": "publish",
                "subject": "source rows",
                "visibility": "with_acquisition"
              }
            }
          ]
        },
        "initial": "enumeration",
        "changes": "observations",
        "deletions": "unsupported",
        "resume": "none",
        "retentionMs": null,
        "gap": "not_applicable",
        "limits": {
          "http_response_bytes": "524288"
        },
        "restrictions": [],
        "commands": {
          "update": {
            "target": "contacts",
            "delivery": "idempotent",
            "condition": "unconditional",
            "replayWindowMs": "360000",
            "maxDeliveryHours": "1",
            "providerEnforcedExpiry": false
          }
        }
      }
    }
  },
  "occurrences": null,
  "artifacts": {
    "raw_archive": false,
    "native_file_transfer_limit_bytes": null,
    "external_versions": false,
    "files": {}
  },
  "commands": {
    "update": {
      "target": "contacts",
      "condition": {
        "kind": "unconditional"
      },
      "delivery": {
        "kind": "idempotent",
        "retention": {
          "kind": "stated",
          "unit": "minutes",
          "value": 6
        },
        "max_delivery_hours": 1,
        "request_expiry": "none"
      }
    }
  }
}

Recorded checks

Requirement	Scope	Evidence	Result
page-publication-recovery	{“kind”:“collection”,“name”:“contacts”}	Native test: integrations/acquisition/acquisition_windows_preserve_sequences_and_restart_fences_old_work (shared_engine)	Execution result unavailable
command-response-lost	{“kind”:“command”,“name”:“update”}	Native test: integrations/listeners/calendar_repair_preserves_accepted_responsibility (shared_engine)	Execution result unavailable
backoff-stated-wait	{“kind”:“connection”}	Native test: integrations/acquisition/backoff_a_stated_wait_defers_the_next_dispatch_and_then_resumes (shared_engine)	Execution result unavailable
budget-shared	{“kind”:“connection”}	Native test: integrations/acquisition/budget_one_bucket_is_spent_by_a_collection_and_by_a_command (shared_engine)	Execution result unavailable
identity-account	{“kind”:“connection”}	Fixture: ./src/connectors/xero/fixtures/identity.json	passed (2026-10-24T21:36:12.548Z)

Hosted qualification: unestablished for this catalog configuration. Installed connections report their own identity, authority and current status.

Provider guidance

Compiled declaration examples and configuration details are published in the connector reference. One organisation per binding: setup tenantId (from GET https://api.xero.com/connections) is sent as xero-tenant-id, and the account identity is the organisation’s OrganisationID. The connection holds a xero credential (xero.credential), an OAuth 2.0 grant. Responses are read as XML, Xero’s default, so every amount is Xero’s own decimal text beside currency. Invoices and contacts are read as paged summaries (summaryOnly=true); the first pass walks every page, each finished pass hands on the latest UpdatedDateUTC it read, and the next one sends If-Modified-Since five minutes before it. Every fullEvery-th pass walks again, which also catches edits Xero states move no timestamp. The record version is UpdatedDateUTC. An invoice with status DELETED is a deletion; VOIDED stays present. Contacts are never deleted, and archived ones are read. invoices create and contacts update send the operation identity as Idempotency-Key, which Xero keeps for six minutes and refuses with a changed request. Xero has no precondition, so both writes are unconditional. updates: "webhooks" admits x-xero-signature deliveries as refresh hints and answers a badly signed one 401, which Xero’s intent-to-receive check requires. A 429’s Retry-After is honoured, and requests share a 60-per-minute budget. Nothing here has run against Xero or been qualified. See the platform’s llm-wiki/wiki/providers/accounting.md.

Provider references

Provider references and prerequisites are maintained in the connector guidance above. No separate provider-documentation review date is recorded.

Source and evidence

Canonical connector source, native analysis and check receipts. Connector artifact: 905888ea276a2a28e36981a79e8142b2547ea451c3e63162cb6915ad4a7d1305. The resource declaration examples above are compiled and compared with exact catalog declarations. Recorded checks apply only to their source, declaration and runtime identities. Configure a connection and inspect its status to establish deployment-specific readiness.

Get Started

Use-case atlas

Platform

Data and Operations

Guides

Client Libraries

Tools

API Reference

Availability

Resources and modes

Invoices and bills

pull: If-Modified-Since pages in XML, DELETED as deletion, idempotency-keyed creates

Configuration: standard

Configuration: readOnly

Contacts

pull: If-Modified-Since pages in XML, archived included, idempotency-keyed updates

Configuration: standard

Provider guidance

Provider references

Source and evidence

​Availability

​Resources and modes

​Invoices and bills

​pull: If-Modified-Since pages in XML, DELETED as deletion, idempotency-keyed creates

​Configuration: standard

​Configuration: readOnly

​Contacts

​pull: If-Modified-Since pages in XML, archived included, idempotency-keyed updates

​Configuration: standard

​Provider guidance

​Provider references

​Source and evidence

Availability

Resources and modes

Invoices and bills

pull: If-Modified-Since pages in XML, DELETED as deletion, idempotency-keyed creates

Configuration: standard

Configuration: readOnly

Contacts

pull: If-Modified-Since pages in XML, archived included, idempotency-keyed updates

Configuration: standard

Provider guidance

Provider references

Source and evidence