pixiManualCreditCreate

Legt eine manuelle Gutschrift (negative Rechnung) zu einer bestehenden Rechnung mit einem Betrag und einem Steuersatz an.

Legt eine Gutschrift an, die auf eine bestehende Rechnung verweist. Die Gutschrift hat keine Artikelpositionen; sie besteht aus einem Betrag und einem Steuersatz.

1. Prüfungen
   • Amount muss größer als 0 sein.
   • VATRate muss H, L oder N sein.
   • Mindestens InvoiceKey oder InvoiceNr muss angegeben werden. Ist nur InvoiceNr angegeben, wird der Schlüssel in Invoices ermittelt. Die Rechnung muss existieren. Sind beide angegeben, müssen sie zur selben Rechnung gehören.
2. Rechnungsdaten: Auftragstyp, Rechnungslager, Kunde, Rechnungs- und Lieferadresse sowie Währung werden aus der ursprünglichen Rechnung übernommen. Das Land stammt aus der Rechnungsadresse.
3. Positionstext: Ist PositionText leer, wird ein Standardtext erzeugt. Bei LanguageId = 1 lautet er Manual Credit: Created From: {InvoiceNr}, sonst Manuell Gutschrift: Erstellt von: {InvoiceNr}. LanguageId ist standardmäßig 2.
4. Steuerberechnung: Die Steuersätze für Land und Auftragstyp werden über Pixi_CA_GetVATList gelesen. Verwendet wird die Zeile mit dem angeforderten VATRate.
   • Bei Auftragstyp B2B gilt Amount als Nettobetrag: netto = −Amount, brutto = −Amount × (1 + MwSt.), auf 2 Stellen gerundet.
   • Bei allen anderen Auftragstypen gilt Amount als Bruttobetrag: brutto = −Amount, netto = −Amount / (1 + MwSt.), auf 2 Stellen gerundet.
5. Limitprüfung: Der absolute Bruttobetrag der neuen Gutschrift wird zur absoluten Summe der Beträge aller Rechnungen addiert, die bereits auf die ursprüngliche Rechnung verweisen (RefToInvoiceKey). Ist das Ergebnis größer als der Rechnungsbetrag der ursprünglichen Rechnung, wird der Aufruf abgelehnt.
6. Anlage: Pixi_CA_InsertManualInvoice legt die Gutschrift an. Dabei wird Folgendes ausgeführt:
   • die nächste Rechnungsnummer wird vergeben;
   • der Datensatz wird in Invoices eingefügt, wobei RefToInvoiceKey/RefToInvoiceNr auf die ursprüngliche Rechnung verweisen;
   • SEPA-Daten und ein InvoicePackage-Datensatz werden ergänzt;
   • die Gutschrift wird auf das Kundenkonto gebucht;
   • das MQ-Event InvoiceCreated wird veröffentlicht.

Der Aufruf liefert eine Statuszeile mit Status und Message.

Parameter

Antwort

Result-Set 1 · Immer; eine Statuszeile (bei seltenen inneren Fehlern kann auf eine OK-Zeile eine Error-Zeile folgen)

Status der Verarbeitung.

<SqlRowSet1>
  <row>
    <Status>OK</Status>
    <Message>Credit created</Message>
  </row>
</SqlRowSet1>

Fehlermeldungen

Beispiele

POST https://apigateway.descartes.com/tms/pixi/
Content-Type: text/xml; charset=utf-8
Authorization: Basic BASE64(USERNAME:PASSWORD)

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://apigateway.descartes.com/tms/pixi/">
  <SOAP-ENV:Body>
    <ns1:pixiManualCreditCreate>
      <!-- <InvoiceKey>104523</InvoiceKey> -->
      <!-- <InvoiceNr>RE2024001234</InvoiceNr> -->
      <!-- <PositionText>Goodwill credit for late delivery</PositionText> -->
      <!-- <LanguageId>2</LanguageId> -->
      <!-- <VATRate>H</VATRate> -->
      <!-- <Amount>25.00</Amount> -->
      <!-- <UserName>api_user</UserName> -->
    </ns1:pixiManualCreditCreate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

curl -X POST 'https://apigateway.descartes.com/tms/pixi/' \
  --user 'USERNAME:PASSWORD' \
  --header 'Content-Type: text/xml; charset=utf-8' \
  --data-binary @- <<'XML'
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://apigateway.descartes.com/tms/pixi/">
  <SOAP-ENV:Body>
    <ns1:pixiManualCreditCreate>
      <!-- <InvoiceKey>104523</InvoiceKey> -->
      <!-- <InvoiceNr>RE2024001234</InvoiceNr> -->
      <!-- <PositionText>Goodwill credit for late delivery</PositionText> -->
      <!-- <LanguageId>2</LanguageId> -->
      <!-- <VATRate>H</VATRate> -->
      <!-- <Amount>25.00</Amount> -->
      <!-- <UserName>api_user</UserName> -->
    </ns1:pixiManualCreditCreate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
XML

<?php

$soapClient = new SoapClient(null, [
    'login' => 'USERNAME',
    'password' => 'PASSWORD',
    'location' => 'https://apigateway.descartes.com/tms/pixi/',
    'uri' => 'https://apigateway.descartes.com/tms/pixi/',
]);

$arguments = [
    // 'InvoiceKey' => '104523',
    // 'InvoiceNr' => 'RE2024001234',
    // 'PositionText' => 'Goodwill credit for late delivery',
    // 'LanguageId' => '2',
    // 'VATRate' => 'H',
    // 'Amount' => '25.00',
    // 'UserName' => 'api_user',
];

$soapArguments = [];
foreach ($arguments as $name => $value) {
    $soapArguments[] = new SoapVar($value, XSD_STRING, '', '', $name);
}

$response = $soapClient->__soapCall('pixiManualCreditCreate', $soapArguments);

Verwendete Tabellen

SQL-Objekt:

dbo.pipiManualCreditCreate

Prozedur zuletzt geändert am 2026-10-05

Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben