Finance & invoicing / Practical guide

Invoice Integration Workflows: Source Event, Document Status and Reconciliation

Invoice integration is a chain of business decisions, not a file export. A reliable design identifies the source event, creates the right document representation, records processing status and reconciles the result with the originating transaction. Country formats and fiscal rules must be scoped separately for each supported environment.

Define the source event

Start by naming the event that makes an invoice eligible: an approved sales invoice, a purchase invoice, a project invoice, a credit note or another documented business transition. Identify the record that owns the event, the company, the customer or vendor and the source status that prevents premature submission.

The source event should have a stable reference that can be carried into the document and response. If the integration receives the same event twice, it should be able to recognize the business identity rather than creating a second document simply because the transport message has a new identifier.

  • Name the event and its approval state
  • Keep company and legal-entity context
  • Define the business reference
  • State which event changes are allowed after submission

Design the document contract

An electronic invoice document contains more than amounts and a customer name. It may require tax registrations, addresses, lines, units, currency, payment terms, references, attachments and a country-specific structure. The contract should identify which values come from the source, which are calculated and which are supplied by a configuration or integration partner.

Do not treat a document schema as a promise that a country’s authority will accept the document. Format validation, signature, gateway delivery and authority response are separate steps. The page should describe software implementation scope and leave legal interpretation to the responsible finance and tax advisers.

Design the document contract: decisions and evidence
LayerWhat it answersExample evidence
SourceWhich approved business transaction is being represented?Invoice ID, company and source status
DocumentWhich fields and format are required?Validated document payload and schema
TransportWhere and how is it submitted?Gateway request, response and correlation ID
Business resultWas it accepted, rejected or awaiting action?Authority or partner result reconciled to source

Separate processing status from invoice status

A submission log can show that a service completed its configured processing pipeline while the invoice itself was rejected by an external authority. These are different facts. Store transport and processing states separately from the final business state so that an operator does not mistake a completed integration step for an accepted invoice.

A useful status model includes scheduled, executing, pending external response, completed processing, failed and cancelled. Add the domain result when the external system provides one: accepted, rejected, corrected, or awaiting manual action. Every status needs an owner and a next action.

  1. Create the source event
  2. Build and validate the document
  3. Submit through the configured service
  4. Record processing and external response separately
  5. Reconcile or route the exception

Reconcile the whole chain

Reconciliation compares the source transaction, generated document, submission response and recorded financial result. It should detect missing responses, duplicate submissions, mismatched totals, incorrect references and a document that appears complete while the authority result is rejected.

Build a review view that helps finance staff answer three questions: which source transaction is affected, what happened at each processing step and what action is safe now. Do not silently overwrite a source document to make an integration look successful. Preserve the history and make correction explicit.

  • Use a shared correlation reference
  • Compare totals, currency and tax-related fields
  • Detect missing or duplicate submissions
  • Keep rejected results visible
  • Record the corrective action

Scope countries and formats honestly

Microsoft’s Electronic invoicing coverage varies by country and release, and some features may be generally available while others are planned or in preview. A proposal should therefore name the country, document types, environment version, service availability and authority or partner route being evaluated.

For Türkiye or any other country, do not infer e-Fatura, e-Arşiv, e-İrsaliye or legal compliance from a generic invoice integration. Confirm the relevant localization, document formats, provider, signature or gateway responsibilities and finance acceptance before publishing a country-specific claim.

  • Country and legal entity
  • Document types and formats
  • Service and provider availability
  • Signature and authority response
  • Finance and tax owner acceptance

Test with representative outcomes

A useful invoice test set includes a valid document, a missing required field, a rejected external response, a duplicate delivery, a delayed response and a correction or cancellation path if the country process supports it. Use masked or synthetic data in development and retain the expected result beside the test record.

Technical logs, document validation and finance acceptance should be reported separately. This gives an honest release statement: the document can be generated, the service can process it, and the business can reconcile the outcome under the agreed country and environment scope.

Primary sources

Sources and further reading.

These platform references support the technical guidance. Available features, versions and implementation requirements should be checked against your environment.