MonduConnecteurStable

Create credit note (Mondu)

Submits an Ormuz credit note to the Mondu invoice it corrects, relying on the explicitly designated source invoice.

Avoir Ormuz

Avoir Mondu

Vue d’ensemble

Create credit note (Mondu) corrects a receivable already materialized by a Mondu invoice. The source_invoice_id relationship precisely identifies the invoice concerned.

This relationship is essential when an order has multiple invoices: the credit note must correct a specific invoice, not the order as a whole.

The credit note must be a platform.invoice with type = credit_note and an already-issued status: issued, sent, or received.
source_invoice_id is required and must designate an invoice already submitted to Mondu.
The credit-note amount cannot exceed the source invoice amount, and currencies must match.
An already-submitted credit note is not created a second time.

Typical scenario

A EUR 600 Mondu invoice has a EUR 100 merchandise return. The ERP issues a credit note linked to this invoice. The node submits the EUR 100 credit note to the relevant invoice.

Quick start

Link only the issued credit note; its source invoice and corresponding order are derived automatically.

Avoir requis

type = credit_note
status ∈ {issued, sent, received}
source_invoice_id populated
PDF in document_file

Source invoice required

Existing Ormuz invoice
Invoice already submitted to Mondu
Invoice linked to exactly one order

Configuration example

Parameter	Binding	Role
`credit_note`	`issued_credit_note`	Issued credit note
`reason`	`Returned goods`	Motif optionnel

Key point The corrected invoice is always the one designated by credit_note.source_invoice_id. The order alone cannot select among multiple invoices.

Process example

invoice.issued event

Transmettre un avoir (Mondu)

Credit note applied to the invoice

When issuing a credit note, use its source invoice to apply the correction to the correct Mondu invoice.

Data resolution

The node automatically derives required data from linked Ormuz objects.

Data	Source or rule
Ormuz source invoice	`credit_note.source_invoice_id`
Order Ormuz	Source invoice → exactly one order
Mondu invoice concerned	Source invoice already submitted to Mondu
Mondu order	`order.id` identifies the financed order
Credit-note reference	`credit_note.id` uniquement
Document	`credit_note.document_file`
Lignes	Persisted credit-note lines

Parameters 3

Contexte principal

Objects and configuration that determine the Mondu operation.

extension_config_idRequisref(extension_config:mondu)

Active Mondu configuration used for the operation. It notably defines environment, default payment method, net term, language, and optional marketplace settings.

credit_noteRequisInvoice

Persisted Ormuz credit note, represented by a platform.invoice with type = credit_note. It must be issued, have a PDF document, and reference its source invoice through source_invoice_id.

Commercial terms

Payment choice, term, and journey settings.

reasonOptionnelstring

Free-form reason sent to Mondu to explain cancellation or credit note, depending on the node.

Outputs 3

Objet Mondu

Primary Mondu object produced or refreshed by the node.

credit_noteMondu credit note

Mondu credit note linked to the relevant source invoice.

Decision and control

Information used to direct the next process step.

createdboolean

Whether the node created a new Mondu object. false means the existing object was found and reused.

Other outputs

extension_object_mappingextension object mapping

Durable mapping between the created or reused Mondu object and the Ormuz object forming its business anchor.

Behavior

Validate the credit note

Type, issued status, amount, tax, currency, and source invoice must be valid.

Identify the corrected invoice

source_invoice_id identifies the relevant Ormuz invoice.

Compare amount and currency

The credit note cannot exceed the source invoice and must use the same currency.

Identify the unique order

The source invoice must be linked to exactly one order.

Check lifecycle consistency

The source invoice must belong to the same Mondu order as the associated order.

Submit or reuse the credit note

An existing credit note is returned with created = false; otherwise the PDF and lines are submitted to Mondu.

Limits and responsibilities

The node does not create the source_invoice_id relationship.
It does not handle a global credit note without a source invoice.
It does not automatically modify Ormuz balances or statuses.
It does not submit a credit note covering multiple source invoices.

Troubleshooting

Source invoice missing

Set credit_note.source_invoice_id to a regular invoice.

Source invoice not submitted

Submit the invoice first with Create invoice (Mondu).

Order missing or ambiguous

The source invoice must be linked to exactly one Ormuz order.

Amount too high

Reduce the credit note or check the selected source invoice.

Document is not PDF

Attach a valid PDF in credit_note.document_file.

Invoice and order inconsistent

Check that the source invoice belongs to the financed order concerned.