MICROEXTRACT DOCUMENTATION

Structured Outputs, API, Webhooks and Integration

Use the simplest delivery method that meets the workflow requirement, then add integration only where it creates measurable operational value.

1. Choose the structured output the downstream process needs

MicroExtract can generate approved Excel, XML, JSON and CSV outputs when those formats are included in the plan and validated template. Do not generate extra formats simply because they are available.

2. Use JSON for structured system exchange

JSON is useful when a downstream service needs machine-readable fields and repeating structures. Treat the approved schema as a contract and version changes deliberately.

3. Confirm API availability before integration

Business and Enterprise plans can include API capability in the commercial plan model. Actual endpoint access, authentication, scope and production readiness must be confirmed for the customer environment before an integration is promised.

The public documentation does not publish an unsupported generic API contract.

4. Confirm webhook availability and event scope

Webhook capability can be part of Business and Enterprise configurations, but event names, retry behaviour, signing and customer-facing availability must be confirmed before production use.

Until a customer-facing webhook contract is explicitly published, do not build against an assumed event schema.

5. Integrate around existing customer systems

MicroExtract is intended to work with existing operational systems rather than forcing an unnecessary replacement. Integration may use approved APIs, folders, email, Microsoft 365, CRM or other systems where access and security approval exist.

6. Raw OCR and source coordinates are not guaranteed customer outputs

The current public product contract focuses on validated structured outputs. Raw OCR text and field coordinates should not be assumed to be available as supported customer outputs unless they are explicitly included in an approved implementation.

Need help with a real document workflow?

Use representative samples, define the required output and validation rules, then test before production use.

Structured Output Selection and Integration Contract

Choose the output required by the receiving process. More file formats do not automatically make a workflow more useful.

Select a representation

FormatUseful evaluation question
XLSXAre sheets, columns and repeating rows practical for a reviewer?
CSVAre quoting, delimiters, encoding and flat rows agreed?
JSONAre object names, arrays, types and missing values explicit?
XMLDoes the structure match the approved target schema?

Keep plan and template restrictions visible

The documented output contract depends on the plan and validated template. Do not show a format as available for a real processing run unless the account permits it.

Usage is based on source pages multiplied by output formats generated. For example, 50 pages in four generated formats is 200 page units. Re-downloading an existing generated result is different from requesting a new run.

Before building an API or webhook integration

Confirm the actual endpoint, authentication, authorisation scope, event names, retry behaviour, signing and idempotency requirements for the customer environment.

The public documentation does not establish an unrestricted generic API or webhook contract. Native ERP connectors, automatic email delivery and source coordinates must not be inferred from a general integration statement.

Keep the handoff traceable

Retain the source reference, job reference, template revision and review decision. Use the simplest approved delivery path that meets the business requirement.

A generated file is not proof that a downstream system accepted it. Test the receiving process independently before automating operational actions.