---
updatedAt: 2026-05-12T10:25:28.000Z
agentTools:
  projectIndex: https://docs.mondu.ai/llms.txt
---

# Create factoring

Create a factoring for invoice

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "API V1",
    "version": "v1"
  },
  "paths": {
    "/api/v1/factorings": {
      "post": {
        "summary": "Create factoring",
        "tags": [
          "Factoring"
        ],
        "description": "Create a factoring for invoice",
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "202": {
            "description": "successful",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FactoringCreate"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden"
          },
          "422": {
            "description": "Unprocessable Entity"
          }
        },
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/CreateFactoringRequest"
              }
            },
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateFactoringRequest"
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.demo.mondu.ai"
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "name": "Api-Token",
        "in": "header"
      }
    },
    "schemas": {
      "UUID": {
        "type": "string",
        "format": "uuid",
        "maxLength": 36,
        "minLength": 36,
        "example": "12345667-890a-bcde-f123-34567890abcd"
      },
      "FactoringState": {
        "type": "string",
        "enum": [
          "processing",
          "pending",
          "approved",
          "declined"
        ]
      },
      "AccountHolder": {
        "type": "string",
        "minLength": 1
      },
      "Date": {
        "type": "string",
        "format": "date"
      },
      "DateTime": {
        "type": "string",
        "format": "date-time"
      },
      "NonEmptyString": {
        "type": "string",
        "minLength": 1
      },
      "Name": {
        "type": "string",
        "minLength": 1,
        "maxLength": 1024
      },
      "ExternalId": {
        "type": "string",
        "minLength": 1,
        "maxLength": 1024,
        "description": "Reference ID of resource in external service"
      },
      "LegalForm": {
        "type": "string",
        "minLength": 1
      },
      "LegalFormCategory": {
        "type": "string",
        "enum": [
          "einzelunternehmen",
          "kapital_und_personen_gesellschaft",
          "offentliche_auftraggeber_einrichtung",
          "andere_gesellschaftsform"
        ]
      },
      "IBAN": {
        "type": "string",
        "minLength": 1
      },
      "Phone": {
        "type": "string",
        "minLength": 1
      },
      "Url": {
        "type": "string",
        "pattern": "^https?://.+$"
      },
      "Email": {
        "type": "string",
        "pattern": "^[^@\\s]+@[^@\\s]+$"
      },
      "Currency": {
        "type": "string",
        "enum": [
          "EUR",
          "GBP"
        ],
        "default": "EUR",
        "description": "Currency code according <a href=\"https://en.wikipedia.org/wiki/ISO_4217\" target=\"_blank\">ISO_4217</a> i.e EUR"
      },
      "CountryCode": {
        "type": "string",
        "enum": [
          "DE",
          "AT",
          "NL",
          "FR",
          "BE",
          "GB",
          "CH",
          "DK",
          "ES",
          "GR",
          "HU",
          "IE",
          "IT",
          "LT",
          "NO",
          "PL",
          "PT",
          "RO",
          "SE",
          "CY",
          "CZ",
          "EE",
          "FI",
          "IS",
          "LV",
          "LU",
          "MT",
          "SK",
          "SI",
          "BG",
          "HR"
        ],
        "default": "DE",
        "description": "Two-letter country code (<a href=\"https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes\" target=\"_blank\">ISO_3166 Alpha 2</a> )i.e DE"
      },
      "Language": {
        "type": "string",
        "enum": [
          "en",
          "de",
          "nl",
          "fr",
          "el"
        ],
        "default": "en",
        "description": "Two-letter language code according to <a href=\"https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes\" target=\"_blank\">ISO_639-1</a> i.e. en"
      },
      "RegistrationID": {
        "type": "string",
        "minLength": 1
      },
      "AmountCents": {
        "type": "integer",
        "minimum": 1
      },
      "AmountCentsCanBeZero": {
        "type": "integer",
        "minimum": 0
      },
      "TaxCents": {
        "type": "integer",
        "minimum": 0
      },
      "NetTerm": {
        "type": "integer",
        "minimum": 1,
        "description": "Custom net term for merchant.Income value must be one of the predefined values in the account"
      },
      "ShippingPriceCents": {
        "type": "integer",
        "minimum": 0
      },
      "DiscountCents": {
        "type": "integer",
        "minimum": 0
      },
      "Quantity": {
        "type": "integer",
        "default": 1,
        "minimum": 1
      },
      "File": {
        "type": "string",
        "format": "binary"
      },
      "FactoringPaymentMethod": {
        "type": "string",
        "enum": [
          "invoice",
          "direct_debit"
        ],
        "default": "invoice"
      },
      "ShippingInfo": {
        "type": "object",
        "description": "Information about the shipment.",
        "properties": {
          "shipping_company": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Name"
              }
            ],
            "description": "Name of the shipping company."
          },
          "shipping_method": {
            "allOf": [
              {
                "$ref": "#/components/schemas/NonEmptyString"
              }
            ],
            "description": "Type of shipping."
          },
          "tracking_number": {
            "allOf": [
              {
                "$ref": "#/components/schemas/NonEmptyString"
              }
            ],
            "description": "Package tracking number."
          },
          "tracking_url": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Url"
              }
            ],
            "description": "An URL to a site with tracking."
          },
          "return_shipping_company": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Name"
              }
            ],
            "description": "Name of the shipping company."
          },
          "return_tracking_number": {
            "allOf": [
              {
                "$ref": "#/components/schemas/NonEmptyString"
              }
            ],
            "description": "Package tracking number."
          },
          "return_tracking_url": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Url"
              }
            ],
            "description": "An URL to a site with tracking."
          }
        }
      },
      "Owner": {
        "type": "object",
        "required": [
          "first_name",
          "last_name"
        ],
        "properties": {
          "first_name": {
            "$ref": "#/components/schemas/Name"
          },
          "last_name": {
            "$ref": "#/components/schemas/Name"
          },
          "birth_date": {
            "$ref": "#/components/schemas/Date"
          },
          "is_authorized": {
            "type": "boolean"
          }
        }
      },
      "CreateFactoringRequest": {
        "type": "object",
        "required": [
          "invoice_external_reference_id",
          "currency",
          "payment_method",
          "net_term",
          "invoice_issued_at",
          "billing_address",
          "shipping_address",
          "buyer"
        ],
        "properties": {
          "invoice_external_reference_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ExternalId"
              }
            ],
            "description": "Invoice ID"
          },
          "currency": {
            "$ref": "#/components/schemas/Currency"
          },
          "net_term": {
            "$ref": "#/components/schemas/NetTerm"
          },
          "payment_method": {
            "allOf": [
              {
                "$ref": "#/components/schemas/FactoringPaymentMethod"
              }
            ],
            "description": "Payment method for the factoring. Can be invoice or direct_debit"
          },
          "total_discount_cents": {
            "$ref": "#/components/schemas/DiscountCents"
          },
          "invoice_issued_at": {
            "$ref": "#/components/schemas/DateTime"
          },
          "gross_amount_cents": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AmountCents"
              }
            ],
            "description": "Invoice amount including taxes, discounts, shipping or any other cost. gross_amount_cents = net_amount_cents + tax_cents + shipping_price_cents - discount_cents"
          },
          "language": {
            "$ref": "#/components/schemas/Language"
          },
          "invoice_url": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Url"
              }
            ],
            "description": "The public URL of the invoice."
          },
          "file": {
            "$ref": "#/components/schemas/File"
          },
          "lines": {
            "$ref": "#/components/schemas/FactoringLines"
          },
          "billing_address": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Address"
              }
            ],
            "description": "Billing address details."
          },
          "shipping_address": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Address"
              }
            ],
            "description": "Shipping address details."
          },
          "buyer": {
            "$ref": "#/components/schemas/BuyerFactoringRequest"
          },
          "owners": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/Owner"
            }
          },
          "shipping_infos": {
            "$ref": "#/components/schemas/ShippingInfo"
          }
        }
      },
      "FactoringCreate": {
        "type": "object",
        "properties": {
          "factoring_uuid": {
            "$ref": "#/components/schemas/UUID"
          },
          "state": {
            "$ref": "#/components/schemas/FactoringState"
          }
        }
      },
      "Address": {
        "type": "object",
        "required": [
          "country_code",
          "city",
          "address_line1",
          "zip_code"
        ],
        "properties": {
          "country_code": {
            "$ref": "#/components/schemas/CountryCode"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/NonEmptyString"
              }
            ],
            "description": "State, county, province, or region."
          },
          "city": {
            "allOf": [
              {
                "$ref": "#/components/schemas/NonEmptyString"
              }
            ],
            "description": "City, district, suburb, town, or village."
          },
          "zip_code": {
            "allOf": [
              {
                "$ref": "#/components/schemas/NonEmptyString"
              }
            ],
            "description": "ZIP or postal code."
          },
          "address_line1": {
            "allOf": [
              {
                "$ref": "#/components/schemas/NonEmptyString"
              }
            ],
            "description": "Street, PO Box, or company name."
          },
          "address_line2": {
            "allOf": [
              {
                "$ref": "#/components/schemas/NonEmptyString"
              }
            ],
            "description": "Apartment, suite, unit, or building."
          }
        }
      },
      "BuyerFactoringRequest": {
        "type": "object",
        "required": [
          "email",
          "first_name",
          "last_name"
        ],
        "description": "Buyer details.",
        "properties": {
          "external_reference_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ExternalId"
              }
            ],
            "description": "Invoice ID"
          },
          "company_name": {
            "$ref": "#/components/schemas/Name"
          },
          "legal_form": {
            "$ref": "#/components/schemas/LegalForm"
          },
          "legal_form_category": {
            "$ref": "#/components/schemas/LegalFormCategory"
          },
          "email": {
            "$ref": "#/components/schemas/Email"
          },
          "phone": {
            "$ref": "#/components/schemas/Phone"
          },
          "first_name": {
            "$ref": "#/components/schemas/Name"
          },
          "last_name": {
            "$ref": "#/components/schemas/Name"
          },
          "iban": {
            "allOf": [
              {
                "$ref": "#/components/schemas/IBAN"
              }
            ],
            "description": "IBAN of the buyer (only if the payment method is Direct Debit)"
          },
          "account_holder": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AccountHolder"
              }
            ],
            "description": "Account holder name (only if the payment method is Direct Debit)"
          },
          "registration_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/RegistrationID"
              }
            ],
            "description": "Registration ID of the buyer (only if the buyer is not from Germany)"
          }
        }
      },
      "FactoringLines": {
        "type": "array",
        "minimum": 1,
        "description": "Invoice line details.",
        "items": {
          "$ref": "#/components/schemas/FactoringLine"
        }
      },
      "FactoringLine": {
        "type": "object",
        "required": [
          "line_items"
        ],
        "properties": {
          "discount_cents": {
            "allOf": [
              {
                "$ref": "#/components/schemas/DiscountCents"
              }
            ],
            "description": "Amount of discount to be applied on this line."
          },
          "shipping_price_cents": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ShippingPriceCents"
              }
            ],
            "description": "Shipping price to be applied on this line."
          },
          "tax_cents": {
            "$ref": "#/components/schemas/TaxCents"
          },
          "line_items": {
            "$ref": "#/components/schemas/FactoringLineItems"
          }
        }
      },
      "FactoringLineItems": {
        "type": "object",
        "required": [
          "external_reference_id",
          "title",
          "net_price_per_item_cents",
          "quantity",
          "tax_cents"
        ],
        "properties": {
          "external_reference_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ExternalId"
              }
            ],
            "description": "Line item ID set by the merchant."
          },
          "title": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Name"
              }
            ],
            "description": "Name of the line item (product or service)."
          },
          "net_price_per_item_cents": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AmountCentsCanBeZero"
              }
            ],
            "description": "The net price of line item without taxes, shipping cost or discounts."
          },
          "tax_cents": {
            "allOf": [
              {
                "$ref": "#/components/schemas/TaxCents"
              }
            ],
            "description": "Amount of tax to be applied on this line item. It is not required, if the tax amount is provided in the line object."
          },
          "quantity": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Quantity"
              }
            ],
            "description": "Number of items. It must be >= 1."
          },
          "net_price_cents": {
            "$ref": "#/components/schemas/AmountCents"
          }
        }
      }
    }
  }
}
```

# Sibling pages

* [Get factoring](https://docs.mondu.ai/reference/get_api-v1-factorings-uuid.md)