Sala, Viðskiptavinir og Vörur - Skilaboðategundir

Yfirskjal: API_Reference.md Útfærslumappa: app/src/Message Type/Implementations/Sales/

Yfirlit

Þetta skjal lýsir Sölu-, Viðskiptavina- og Vöru-skilaboðategundunum í Cloud Events API. Þessar skilaboðategundir bjóða upp á viðskiptaaðgerðir fyrir lánstraust viðskiptavina, vörugæðar, verðlag, verkferla sölupantana og PDF skjalasækingu.

Athugið: Allar PDF-skilaboðategundir styðja uppflettingu bæði með skjalanúmeri og SystemId (GUID).

Customer.CreditLimit.Get

Tilgangur: Sækja lánstraustaupplýsingar viðskiptavinar þ.m.t. stöðu, útistandandi upphæðir og lánstraustaástand.

Lýsing: Sækir lánstraustaupplýsingar þ.m.t. stöðu, útistandandi upphæðir, eftirstandandi lán (með og án þolinmæðihlutfalls) og lánstígandavísar.

Stefna skilaboða: Útlæg

Inntaksfæribreytur:

Viðskiptavinarnúmer má tilgreina annað hvort í subject reitnum eða í data færibreytum:

Möguleiki 1: Nota subject reit

{ "subject": "10000" }

Möguleiki 2: Nota JSON gagnafæribreytur

{ "data": { "customerNo": "10000" } }

Möguleiki 3: Nota SystemId viðskiptavinar

{ "data": { "customerId": "{12345678-1234-1234-1234-123456789012}" } }

Snið svars:

{
  "status": "Success",
  "customerNo": "10000",
  "customerName": "Adatum Corporation",
  "balanceLCY": 1234.56,
  "outstandingBalanceDueLCY": 500.00,
  "creditLimitLCY": 10000.00,
  "outstandingAmountLCY": 2000.00,
  "remainingCredit": 6765.44,
  "tolerancePercent": 10.00,
  "remainingCreditWithTolerance": 7765.44,
  "hasOverdueBalance": true,
  "isCreditLimitExceeded": false
}

Svarreitir:

• status: Vinnslustöðu ("Success" eða "Error")
• customerNo: Viðskiptavinarnúmer
• customerName: Nafn viðskiptavinar
• balanceLCY: Núverandi staða í SGM (Customer."Balance (LCY)")
• outstandingBalanceDueLCY: Útistandandi staða sem er gjaldfallin í SGM
• creditLimitLCY: Lánstraustamark í SGM
• outstandingAmountLCY: Útistandandi upphæð af sölupöntunum
• remainingCredit: Eftirstandandi lán án þolinmæðihlutfalls
• tolerancePercent: Þolinmæðihlutfall frá Cloud Events Setup
• remainingCreditWithTolerance: Eftirstandandi lán með þolinmæðihlutfalli
• hasOverdueBalance: Boolean — hvort gjaldfallin staða sé til
• isCreditLimitExceeded: Boolean — hvort lánstraustamark sé farið yfir (tekur tillit til þolinmæðihlutfalls)

Dæmi um útreikning:

Gefið:

• Lánstraustamark: 10.000,00 SGM
• Núverandi staða: 5.000,00 SGM
• Útistandandi pantanir: 5.500,00 SGM
• Þolinmæðihlutfall: 10,00%

Útreikningur:

• Notað lán: 5.000 + 5.500 = 10.500,00 SGM
• Eftirstandandi lán: 10.000 − 10.500 = −500,00 SGM
• Þolinmæðiupphæð: 10.000 × 0,10 = 1.000,00 SGM
• Eftirstandandi m. þolinmæði: −500 + 1.000 = 500,00 SGM
• Er farið yfir: false (eftirstandandi með þolinmæði > 0)

Customer.SalesHistory.Get

Tilgangur: Sækja söluferil eftir vöru fyrir tiltekinn viðskiptavin á tímabili.

Lýsing: Sækir söluferilsupplýsingar um hvaða vörur viðskiptavinur hefur keypt, þ.m.t. fjölda pantana og mælieiningar. Byggt á vörufjárhagsfærslum viðskiptavinar á tímabili.

Stefna skilaboða: Útlæg

Inntaksfæribreytur:

{
  "subject": "10000",
  "data": {
    "fromDate": "2025-01-01",
    "toDate": "2025-12-31"
  }
}

Snið svars:

{
  "status": "Success",
  "noOfRecords": 5,
  "customerNo": "10000",
  "customerName": "Adatum Corporation",
  "fromDate": "2025-01-01",
  "toDate": "2025-12-31",
  "salesHistory": [
    {
      "itemNo": "1000",
      "variantCode": "",
      "description": "Bicycle",
      "baseUnitOfMeasure": "PCS",
      "baseUOMDescription": "Piece",
      "noOfOrders": 3
    }
  ]
}

Athugasemdir:

• Söluferill byggist á vörufjárhagsfærslum með Entry Type = Sale
• noOfOrders telur fjölda vörufjárhagsfærslna á tímabilinu á hverja vöru
• Niðurstöður raðaðar eftir vörunúmeri í hækkandi röð

Customer.Statement.Pdf

Tilgangur: Sækja reikning viðskiptavinar sem PDF-skjal.

Lýsing: Sækir reikning viðskiptavinar sem PDF-skjal, með valfrjálsu dagsetningartímabili. Sjálfgefið er síðustu 30 dagar.

Stefna skilaboða: Útlæg

Inntaksfæribreytur:

Viðskiptavinarnúmer eða SystemId verður að vera í subject reitnum:

{
  "specversion": "1.0",
  "type": "Customer.Statement.Pdf",
  "source": "MyApp v1.0",
  "subject": "10000",
  "data": "{\"startDate\":\"2026-01-01\",\"endDate\":\"2026-03-20\"}"
}

Snið svars:

{
  "downloadUrl": "/api/origo/cloudEvent/v1.0/responses({guid})",
  "contentType": "application/pdf"
}

Kallaðu á downloadUrl til að sækja PDF skjalið.

Athugasemdir:

• Útfærslan er stýranleg með Customer Statement Type í Cloud Events Setup
• Sjálfgefin útfærsla notar skýrsluval fyrir C.Statement

Item.Availability.Get

Tilgangur: Sækja gæðaupplýsingar vöru þ.m.t. birgðamagn og framboðsstöðu.

Lýsing: Sækir gæðaupplýsingar vöru byggt á stilltri útreikningartegund (Raunbirgðir eða Reiknað magn). Styður einnar-vöru og fjölvöru-fyrirspurnir. Skilar upplýsingum í items fylki þar sem hver vara inniheldur sitt eigið birgða-/framboðsupplýsingafylki.

Stefna skilaboða: Útlæg

Uppfletting vöru:

Vöruuppfletting fer eftir eftirfarandi forgangi:

1. subject — GUID leysist sem SystemId; texti leysist sem vörunúmer
2. data.itemNo — Vörunúmer (hefur forgang yfir subject)
3. data.itemId — SystemId vöru (GUID)
4. data.id / data.systemId / data.recordSystemId — SystemId vöru (GUID)
5. data.tableView — BC AL töflusíustrengur fyrir fjölvöru-fyrirspurnir
6. Ef ekkert er tilgreint skilar gæðum allra ólokaðra vara

Möguleiki 1: Ein vara eftir númer (subject)

{
  "subject": "1000",
  "data": {
    "requested-delivery-date": "2026-03-15",
    "locationFilter": "BLUE|RED"
  }
}

Möguleiki 2: Ein vara eftir JSON gagnafæribreytu

{
  "data": {
    "itemNo": "1000",
    "locationFilter": "BLUE"
  }
}

Möguleiki 3: Ein vara eftir SystemId

{
  "data": {
    "itemId": "{12345678-1234-1234-1234-123456789012}",
    "locationFilter": "BLUE"
  }
}

Möguleiki 4: Margar vörur með tableView síu

{
  "data": {
    "tableView": "WHERE(Item Category Code=CONST(FURNITURE))",
    "locationFilter": "BLUE"
  }
}

Inntaksfæribreytur:

• subject (valfrjálst): Vörunúmer eða SystemId (GUID). Má tilgreina hér eða í gagnafæribreytum.
• itemNo (valfrjálst): Vörunúmer í data reit. Hefur forgang yfir subject.
• itemId (valfrjálst): SystemId vöru (GUID) í data reit. Notað ef itemNo er ekki gefið.
• id / systemId / recordSystemId (valfrjálst): SystemId vöru (GUID) valkostir.
• tableView (valfrjálst): BC AL töflusíustrengur til að velja margar vörur. Notar staðlaða BC setningafræði.
• requested-delivery-date (valfrjálst): Dagsetning til að reikna framboð miðað við (ISO 8601 snið).
• locationFilter (valfrjálst): Einn eða fleiri staðsetningarkóðar, aðskildir með |.

Snið svars — Raunbirgðir:

{
  "status": "Success",
  "items": [
    {
      "itemNo": "1000",
      "itemDescription": "Bicycle",
      "baseUnitOfMeasure": "PCS",
      "inventory": [
        { "locationCode": "BLUE", "inventory": 50 },
        { "locationCode": "RED", "inventory": 30 }
      ]
    }
  ]
}

Snið svars — Reiknað magn:

{
  "status": "Success",
  "items": [
    {
      "itemNo": "1000",
      "itemDescription": "Bicycle",
      "baseUnitOfMeasure": "PCS",
      "requestedDeliveryDate": "2026-03-15",
      "availability": [
        {
          "locationCode": "BLUE",
          "inventory": 50,
          "qtyReserved": 10,
          "grossRequirement": 20,
          "scheduledReceipt": 30,
          "plannedOrderReceipt": 15,
          "availableQuantity": 65
        }
      ]
    }
  ]
}

Snið svars — Margar vörur (Raunbirgðir):

{
  "status": "Success",
  "items": [
    {
      "itemNo": "1000",
      "itemDescription": "Bicycle",
      "baseUnitOfMeasure": "PCS",
      "inventory": [
        { "locationCode": "BLUE", "inventory": 50 }
      ]
    },
    {
      "itemNo": "1001",
      "itemDescription": "Touring Bicycle",
      "baseUnitOfMeasure": "PCS",
      "inventory": [
        { "locationCode": "BLUE", "inventory": 25 }
      ]
    }
  ]
}

Gæðategundir:

Villutilvik:

• "No items found matching the specified criteria." — engin vara samræmist tilgreindri síu/auðkenni

Uppsetning: Stýrð með Item Calc. Availability Type í Cloud Events Setup.

Item.Price.Get

Tilgangur: Sækja verðlýsigögn vöru úr verðlistum.

Lýsing: Sækir verðupplýsingar vöru úr verðlistum byggt á viðskiptavini, umbeðinni afhendingardagsetningu, magni og afbrigðissíum. Styður einnar-vöru og fjölvöru-fyrirspurnir. Skilar verðlistalínum í priceListLines fylki þar sem hver lína inniheldur itemNo reit til auðkenningar.

Stefna skilaboða: Útlæg

Uppfletting vöru:

Sama uppfletting og Item.Availability.Get:

1. subject — GUID leysist sem SystemId; texti leysist sem vörunúmer
2. data.itemNo — Vörunúmer (hefur forgang yfir subject)
3. data.itemId — SystemId vöru (GUID)
4. data.id / data.systemId / data.recordSystemId — SystemId vöru (GUID)
5. data.tableView — BC AL töflusíustrengur fyrir fjölvöru-fyrirspurnir
6. Ef ekkert er tilgreint skilar verðum allra ólokaðra vara

Forgangur uppflettingar viðskiptavinar:

1. data.customerNo — Viðskiptavinarnúmer (Code)
2. data.customerId — SystemId viðskiptavinar (GUID)
3. data.customerRecordId — SystemId viðskiptavinar (GUID)
4. data.customerSystemId — SystemId viðskiptavinar (GUID)
5. Ef ekkert er tilgreint skilar aðeins almennu verði

Inntaksfæribreytur:

• subject (valfrjálst): Vörunúmer eða SystemId (GUID). Má tilgreina hér eða í gagnafæribreytum.
• itemNo (valfrjálst): Vörunúmer í data reit. Hefur forgang yfir subject.
• itemId (valfrjálst): SystemId vöru (GUID) í data reit.
• id / systemId / recordSystemId (valfrjálst): SystemId vöru (GUID) valkostir.
• tableView (valfrjálst): BC AL töflusíustrengur til að velja margar vörur.
• customerNo (valfrjálst): Viðskiptavinarnúmer (Code) fyrir sértækt verðlag.
• customerId (valfrjálst): SystemId viðskiptavinar (GUID) fyrir sértækt verðlag.
• customerRecordId (valfrjálst): SystemId viðskiptavinar (GUID) valkostur.
• customerSystemId (valfrjálst): SystemId viðskiptavinar (GUID) valkostur.
• requestedDeliveryDate (valfrjálst): Dagsetning til að sía verðlista eftir upphafs-/lokadagsetningu (ISO 8601 snið).
• quantity (valfrjálst): Magn til sía eftir lágmarksmagni.
• variantCode (valfrjálst): Afbrigðiskóði vöru.

Staðfesting viðskiptavinar:

Þegar viðskiptavinur er auðkenndur (customerNo, customerId, customerRecordId eða customerSystemId) er viðskiptavinurinn sannreyndur áður en verðútreikningur fer fram. Eftirfarandi verður að vera stillt á viðskiptavininn:

• VSK-viðskiptabókunarflokkur — nauðsynlegur fyrir VSK-útreikning
• Alm. viðskiptabókunarflokkur — nauðsynlegur fyrir almenna bókun
• Bókunarflokkur viðskiptavinar — nauðsynlegur fyrir bókun viðskiptavinar

Ef eitthvað vantar er villusvar skilað (t.d. "Customer C001 must have a VAT Bus. Posting Group.").

Snið svars:

{
  "status": "Success",
  "priceListLines": [
    {
      "priceListCode": "RETAIL-2026",
      "priceListDescription": "Retail Price List 2026",
      "lineNo": 10000,
      "itemNo": "1000",
      "variantCode": "BLUE",
      "unitOfMeasureCode": "PCS",
      "qtyPerUnitOfMeasure": 1.0,
      "minimumQuantity": 10,
      "amountType": "Price",
      "unitPrice": 950.00,
      "unitPriceExclVAT": 950.00,
      "unitPriceInclVAT": 1178.00,
      "lineDiscountPct": 5.0,
      "vatPct": 24.0,
      "itemName": "Bicycle",
      "itemDescription": "Touring Model",
      "baseUnitOfMeasure": "PCS",
      "eanCode": "5701234560013",
      "unspscCode": "87111501",
      "netWeight": 12.5,
      "itemSystemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "priceType": "Customer",
      "status": "Active",
      "startingDate": "2026-01-01",
      "endingDate": "2026-12-31"
    }
  ]
}

Forgangur verðvals:

1. Viðskiptavin-sértækt verð — ef customerNo er gefið
2. Almennt verð (allir viðskiptavinir) — ef ekkert sértækt verð finnst
3. Verð af birgðarspjaldi — ef engar verðlistalínur finnast, skilar Unit Price og Unit Cost

Villutilvik:

• "No items found matching the specified criteria." — engin vara samræmist tilgreindri síu/auðkenni
• "Customer {no} not found." — ógilt viðskiptavinarnúmer eða SystemId
• "Customer {no} must have a VAT Bus. Posting Group." — vantar bókunarflokk
• "Customer {no} must have a Gen. Bus. Posting Group." — vantar bókunarflokk
• "Customer {no} must have a Customer Posting Group." — vantar bókunarflokk

Sales.Document.Release

Tilgangur: Gefa út opna sölupöntun til að gera hana tilbúna til vinnslu og bókunar.

Lýsing: Gefur út sölupöntun með því að breyta stöðu hennar úr Opið í Gefin út. Þetta sannprófar pöntunina, læsir hana fyrir breytingum og gerir hana tiltæka til frekari vinnslu.

Stefna skilaboða: Innlæg

Inntaksfæribreytur:

{ "subject": "SO-1001" }

eða:

{ "data": { "orderNo": "SO-1001" } }

Uppfletting skjals:

• Texti í subject flettir sjálfgefið upp skjalagerð = Order
• Notaðu sérstaka data JSON lykla fyrir aðrar tegundir: invoiceNo, creditMemoNo, returnOrderNo, quoteNo, blanketOrderNo
• GUID (SystemId) í subject eða data (systemId, id, recordSystemId) finnur skjalið óháð tegund

Snið svars:

{
  "status": "Success",
  "documentType": "Order",
  "documentNo": "SO-1001",
  "customerNo": "C001",
  "customerName": "Contoso Ltd.",
  "statusBefore": "Open",
  "statusAfter": "Released",
  "documentDate": "2025-05-15",
  "amount": 1100.00,
  "amountIncludingVAT": 1364.00
}

Villutilvik:

• "Document identifier must be specified in subject field or request JSON (systemId, recordSystemId, id, orderNo, quoteNo, invoiceNo, creditMemoNo, blanketOrderNo, returnOrderNo)." — Ekkert skjalaauðkenni tilgreint
• "Sales document not found." — Skjal fannst ekki
• "Sales Order {No} is already released. Current Status: {Status}" — Þegar gefin út

Sales.Document.Reopen

Tilgangur: Opna aftur söluskjal til að leyfa breytingar.

Lýsing: Opnar aftur söluskjal með stöðu Released eða Pending Approval og breytir stöðu þess aftur í Open. Fyrir skjöl í Pending Approval án samþykktarfærslna er staðan stillt beint á Open. Þetta gerir kleift að gera breytingar á skjali sem var áður gefið út eða beið samþykktar.

Stefna skilaboða: Innlæg

Inntaksfæribreytur:

{ "subject": "SO-1001" }

Uppfletting skjals:

• Texti í subject flettir sjálfgefið upp skjalagerð = Order
• Notaðu sérstaka data JSON lykla fyrir aðrar tegundir: invoiceNo, creditMemoNo, returnOrderNo, quoteNo, blanketOrderNo
• GUID (SystemId) í subject eða data (systemId, id, recordSystemId) finnur skjalið óháð tegund

Snið svars:

{
  "status": "Success",
  "documentType": "Order",
  "documentNo": "SO-1001",
  "customerNo": "C001",
  "customerName": "Contoso Ltd.",
  "statusBefore": "Released",
  "statusAfter": "Open",
  "documentDate": "2025-05-15",
  "amount": 1100.00,
  "amountIncludingVAT": 1364.00
}

Sales.Document.Statistics

Tilgangur: Sækja tölfræðilegar upplýsingar sölupöntunar þ.m.t. upphæðir, VSK-heildir, magn, þyngd og rúmmál.

Lýsing: Sækir ítarlegar tölfræðilegar upplýsingar sölupöntunar. Þetta er lesaðgerð eingöngu sem veitir sömu upplýsingar og sjást á síðu 402 "Sales Document Statistics" í Business Central.

Stefna skilaboða: Útlæg

Inntaksfæribreytur:

{ "subject": "SO-1001" }

eða með SystemId:

{ "subject": "{12345678-1234-1234-1234-123456789012}" }

Uppfletting skjals:

• Texti í subject flettir sjálfgefið upp skjalagerð = Order
• Notaðu sérstaka data JSON lykla fyrir aðrar tegundir: invoiceNo, creditMemoNo, returnOrderNo, quoteNo, blanketOrderNo
• GUID (SystemId) í subject eða data (systemId, id, recordSystemId) finnur skjalið óháð tegund

Snið svars:

{
  "status": "Success",
  "documentType": "Order",
  "documentNo": "SO-1001",
  "customerNo": "10000",
  "customerName": "Adatum Corporation",
  "currencyCode": "",
  "documentDate": "2026-03-07",
  "order": {
    "amount": 5000.00,
    "lineDiscountAmount": 150.00,
    "invoiceDiscountAmount": 250.00,
    "totalExclVAT": 4750.00,
    "vatAmount": 1187.50,
    "totalInclVAT": 5937.50,
    "quantity": 100,
    "totalWeight": 125.50,
    "totalVolume": 2.35,
    "noOfVATLines": 1
  },
  "vat_totals": [
    {
      "vatIdentifier": "STANDARD",
      "vatPct": 25.00,
      "lineAmount": 5000.00,
      "vatBase": 4750.00,
      "vatAmount": 1187.50,
      "amountInclVAT": 5937.50
    }
  ]
}

Pöntunarsvarreitir:

• amount: Heildarlínuupphæð án VSK
• lineDiscountAmount: Summa allra línuafsláttar
• invoiceDiscountAmount: Heildar reikningsafsláttur
• totalExclVAT: Heildarupphæð án VSK (eftir alla afslætti)
• vatAmount: Heildar VSK-upphæð
• totalInclVAT: Heildarupphæð með VSK
• quantity: Heildarmagn allra lína
• totalWeight: Heildarþyngd (summa magns × brúttóþyngd)
• totalVolume: Heildatrúmmál (summa magns × einingunarrúmmál)
• noOfVATLines: Fjöldi mismunandi VSK-hlutfalla

VSK-heildir fylki:

Inniheldur eina færslu á hvert VSK-hlutfall:

• vatIdentifier: VSK-flokkur
• vatPct: VSK-hlutfallið
• lineAmount: Heildarlínuupphæð þessa VSK-hlutfalls
• vatBase: Upphæð sem VSK er reiknaður á
• vatAmount: VSK-upphæð
• amountInclVAT: Heildarupphæð með VSK

Sales.Document.Post

Tilgangur: Bóka sölupöntun og skila bókuðu reikningsnúmeri.

Lýsing: Bókar sölupöntun með BC staðlaðri Sales-Post kóðaeiningu. Pöntunin verður að hafa a.m.k. eina línu. Eftir vel heppnaða bókun er upprunaleg sölupöntun eytt, bókaður sölureikningur stofnaður og svarið inniheldur bæði upprunaleg pöntunarnúmer og nýtt bókað reikningsnúmer.

Stefna skilaboða: Innlæg

Inntaksfæribreytur:

{ "subject": "SO-1001" }

Uppfletting skjals:

• Texti í subject flettir sjálfgefið upp skjalagerð = Order
• Notaðu sérstaka data JSON lykla fyrir aðrar tegundir: invoiceNo, creditMemoNo, returnOrderNo, quoteNo, blanketOrderNo
• GUID (SystemId) í subject eða data (systemId, id, recordSystemId) finnur skjalið óháð tegund

Snið svars:

{
  "status": "Success",
  "documentNo": "SO-1001",
  "postedInvoiceNo": "PI-1001",
  "customerNo": "10000",
  "customerName": "Adatum Corporation",
  "documentDate": "2026-03-10",
  "postingDate": "2026-03-16",
  "amount": 5000.00,
  "amountIncludingVAT": 6200.00
}

Villutilvik:

Sales.SalesInvoice.Pdf

Tilgangur: Sækja bókaðan sölureikning sem PDF-skjal.

Lýsing: Sækir bókaðan sölureikning sem PDF-skjal með stilltri skýrsluval. Hægt er að tilgreina reikningsnúmer eða SystemId.

Stefna skilaboða: Útlæg

Inntaksfæribreytur:

{ "subject": "103001" }

eða:

{ "data": { "invoiceNo": "103001" } }

Snið svars:

{
  "downloadUrl": "/api/origo/cloudEvent/v1.0/responses({guid})",
  "contentType": "application/pdf"
}

Sales.SalesShipment.Pdf

Tilgangur: Sækja bókað almennutslipp sem PDF-skjal.

Stefna skilaboða: Útlæg

Inntaksfæribreytur: subject með shipping-númeri eða SystemId, eða data.shipmentNo.

Snið svars: Sama og SalesInvoice.Pdf — downloadUrl og contentType: "application/pdf".

Sales.SalesCreditMemo.Pdf

Tilgangur: Sækja bókað kreditreikningsskjal sem PDF-skjal.

Stefna skilaboða: Útlæg

Inntaksfæribreytur: subject með kreditreikningsnúmeri eða SystemId, eða data.creditMemoNo.

Snið svars: Sama og SalesInvoice.Pdf — downloadUrl og contentType: "application/pdf".

Sales.ReturnReceipt.Pdf

Tilgangur: Sækja bókað skilakvittunaskjal sem PDF-skjal.

Stefna skilaboða: Útlæg

Inntaksfæribreytur: subject með skilakvittunarnúmeri eða SystemId.

Snið svars: Sama og SalesInvoice.Pdf — downloadUrl og contentType: "application/pdf".

Sales.Document.PreviewPost

Tilgangur: Líkir eftir bókun söluskjals og skilar öllum færslubókum sem yrðu stofnaðar án þess að framkvæma bókun (transaction er rollback-ð í lokin).

Lýsing: Keyrir alla staðlaða BC bókunarrútínu (Codeunit "Sales-Post (Yes/No)") gegnum Codeunit "Gen. Jnl.-Post Preview". Allar færslur sem yrðu stofnaðar eru gripnar í tímabundnar töflur og síðan er transaction rollback-að. Engin gögn eru vistuð; upprunalegt söluskjal er óbreytt eftir kallið. Notist til að sannreyna hvort hægt sé að bóka skjal, sýna AI-umboðsmanni nákvæmar fjárhagslegar afleiðingar eða birta fyrirsjáanleg skjalanúmer og heildir fyrir bókun.

Stefna skilaboða: Innlæg

Inntaksfæribreytur:

Sömu uppflettingarreglur og Sales.Document.Post. Stúðningur við Order, Invoice, Credit Memo og Return Order.

Cloud Event færibreytur:

• source (áskilið): Lýsing á forritinu sem kallar.
• subject (áskilið/valkvætt): Skjalanúmer söluskjals eða SystemId (GUID). Einnig hagt að senda í data.
• data (valkvætt): JSON-hlutur með auðkenni skjals. Fyrsti lykill sem passar vinnur:
• systemId / recordSystemId / id: SystemId færslunnar (GUID).
• orderNo: Númer sölupöntunar (Document Type = Order).
• invoiceNo: Númer sölureiknings.
• creditMemoNo: Númer sölukreditreiknings.
• returnOrderNo: Númer söluskilapöntunar.

Aðferðir til að velja skjal: Hvaða eitt sem er af eftirfarandi auðkennir skjalið:

1. subject sem texti — flettið upp sem No. á öllum fjórum skjalategundum.
2. subject sem GUID — flettið upp sem SystemId á Sales Header.
3. data.systemId / data.recordSystemId / data.id — SystemId uppfletting.
4. data.orderNo / data.invoiceNo / data.creditMemoNo / data.returnOrderNo — No. uppfletting takmörkuð við rétta Document Type.

{ "specversion": "1.0", "type": "Sales.Document.PreviewPost", "source": "MyApp", "subject": "SO-001" }

Snið svars:

{
  "status": "Success",
  "rollback": true,
  "summary": "Preview-posting Order SO-001 for customer C01 would create 6 ledger entries across 6 tables. Transaction is balanced.",
  "documentType": "Order",
  "documentNo": "SO-001",
  "customerNo": "C01",
  "customerName": "Acme Customer",
  "lcyCode": "ISK",
  "documentCurrencyCode": "EUR",
  "documentExchangeRate": 145.0,
  "predictedNumbers": { "postedInvoiceNo": "SI-00045", "postedShipmentNo": "SS-00045" },
  "totals": {
    "balanced": true,
    "totalDebitLCY": 145000.00, "totalCreditLCY": 145000.00,
    "totalDebitFCY": 1000.00, "totalCreditFCY": 1000.00
  },
  "preview": [
    { "tableId": 17, "tableName": "G/L Entry", "entryCount": 3, "entries": [ /* full row JSON per entry */ ] },
    { "tableId": 254, "tableName": "VAT Entry", "entryCount": 1, "entries": [ ] },
    { "tableId": 32, "tableName": "Item Ledger Entry", "entryCount": 1, "entries": [ ] },
    { "tableId": 5802, "tableName": "Value Entry", "entryCount": 1, "entries": [ ] },
    { "tableId": 21, "tableName": "Cust. Ledger Entry", "entryCount": 1, "entries": [ { "Amount": 1000.00, "AmountLCY": 145000.00, "CurrencyCode": "EUR" } ] },
    { "tableId": 380, "tableName": "Detailed Cust. Ledg. Entry", "entryCount": 1, "entries": [ ] }
    /* Aðrar færslubókartöflur sem snertast (t.d. Job Ledger Entry, FA Ledger Entry, Bank Account Ledger Entry) birtast hér þegar skjalið hefur áhrif á þær */
  ]
}

Reitir í svari:

• status: "Success" eða "Error".
• rollback: Alltaf true við vel heppnað preview — upprunalegt skjal er óbreytt.
• summary: Stutt mannlesanleg lýsing.
• documentType: "Order", "Invoice", "Credit Memo" eða "Return Order".
• documentNo: Númer upprunalegs söluskjals.
• customerNo / customerName: Viðskiptavinur skjalsins.
• lcyCode: Staðbundinn gjaldmiðill (LCY) úr G/L Setup.
• documentCurrencyCode: Tómt þegar skjalið er í LCY.
• documentExchangeRate: FCY→LCY gengi. **Alltaf 1 þegar documentCurrencyCode er tómt.**
• predictedNumbers: Skjalanúmer sem No. Series myndi úthluta á þessu augnabliki. Fyrir Order: postedInvoiceNo + postedShipmentNo; fyrir Invoice: postedInvoiceNo; fyrir Credit Memo: postedCreditMemoNo; fyrir Return Order: postedCreditMemoNo + postedReturnReceiptNo. Aðeins til upplýsinga — ekki frátekið.
• totals.balanced: true þegar LCY debet jafnt og LCY kredit (námundað í 0,01).
• totals.totalDebit\ / totalCredit\: Heildir G/L Entry debet/kredit í LCY og FCY.
• preview[]: Eitt stak fyrir hverja færslubókartöflu sem BC bókunarrútína fyllir. Töflur eru fundnar kvikt í gegnum Codeunit "Posting Preview Event Handler".FillDocumentEntry(). Innbyggður stuðningur er fyrir 17 BC færslubókartöflur og framlengingar geta bætt við töflum í gegnum OnGetPreviewFieldNames atburð á Codeunit "Cloud Event Preview Helper".
• preview[].entries[]: Full JSON-röð fyrir hverja gripna færslu. Reitanöfn nota vélræna umbreytingu (No. → No_, Amount (LCY) → AmountLCY o.s.frv.). Reitir sem eru takmarkaðir í Cloud Events Field Access eru ekki birtir.

Gjaldmiðilsregla:

documentCurrencyCode == "" ⇒ documentExchangeRate == 1 ∧ totalDebitFCY == totalDebitLCY ∧ totalCreditFCY == totalCreditLCY

Þegar skjalið er í LCY speglar FCY dálkurinn LCY dálkinn og gengið er 1.

Fyrirsjáanleg vs raunveruleg númer: Milli preview og raunverulegrar bókunar getur önnur transaction nýtt fyrirsjáanleg No. Series númer, þannig að raunveruleg bókuð númer geta verið önnur. Notið predictedNumbers aðeins til upplýsinga.

Athugasemdir:

• Notar BC Codeunit "Gen. Jnl.-Post Preview" til að keyra Codeunit "Sales-Post (Yes/No)" í preview-ham.
• Sameiginleg Codeunit "Cloud Event Preview Helper" raðskýrir hverja töflu og veitir OnGetPreviewFieldNames og OnPrecalculateFlowFields framlengingaratburði.
• Síutöflunr: 36 (Sales Header).
• Stefna skilaboða: Innlæg.

Villuaðstæður:

• Söluskjal finnst ekki → {"status":"Error","error":"..."}.
• Skjal hefur engar línur → villa með skilaboðum um "no lines".
• Hvers konar bókunarvillu BC → undirliggjandi villutexti er skilað.

Tengdar skilaboðategundir:

• Sales.Document.Post: Framkvæmir raunverulega bókun (engin rollback).
• Sales.Document.Statistics: Heildir haus/lína án þess að líkja eftir bókun.

Tengd skjöl

• API_Reference.md: API-endapunktar og auðkenning
• Setup_Reference.md: Uppsetningarhandbók — útfærsluval
• Data_Message_Types.md: Gagna-skilaboðategundir
• Purchase_Message_Types.md: Innkaupa-skilaboðategundir

Customer.Application.Post

Tilgangur: Jafnar f�rslu vi�skiptavinar (j�fnunarf�rsluna) � m�ti einni e�a fleiri opnum f�rslum vi�skiptavinar og b�kar j�fnunina � gegnum Microsoft codeunit 226 "CustEntry-Apply Posted Entries".

L�sing: Endurspeglar heg�un s��unnar Apply Customer Entries. Reitirnir "Applies-to ID" og "Amount to Apply" eru settir � j�fnunarf�rsluna, hver markf�rsla f�r sama Applies-to ID, og CustEntry-Apply Posted Entries.Apply b�kar j�fnunina. Allar f�rslur ver�a a� tilheyra sama vi�skiptavini.

Stefna skilabo�a: Innl�g

Studdar t�flur: Cust. Ledger Entry (21)

Sni� bei�ni

Cloud Event f�ribreytur:

*J�fnunarf�rsluna m� einnig au�kenna me� systemId, recordSystemId, id, entryNo e�a entryNumber � bei�nar-JSON.

Bei�nar-JSON:

Svar

Sj� enska �tg�fu fyrir n�kv�mt JSON-sni� og reital�singar. Toppreitir: status, applyingEntryNo, applyingRecordSystemId, customerNo, documentNo, postingDate, amountToApply, totalApplied, remainingAmount, open, applications[].

Villu�stand

• Au�kenni vantar � subject og bei�ni.
• J�fnunarf�rsla fannst ekki.
• J�fnunarf�rsla er ekki opin.
• appliesToEntries vantar e�a er t�mur.
• Markf�rsla tilheyrir ��rum vi�skiptavini.
• Markf�rsla er loku�.
• Codeunit 226 hafna�i j�fnun (svar er JSON me� villubo�um og callstack).

Tengdar skilabo�ategundir

• Customer.Application.Reverse - Bakar b�ka�ri j�fnun.
• Customer.CreditLimit.Get - L�nstraustauppl�singar vi�skiptavinar.

Customer.Application.Reverse

Tilgangur: Bakar (aftengir) b�ka�a j�fnun � f�rslu vi�skiptavinar � gegnum Microsoft codeunit 226 "CustEntry-Apply Posted Entries.PostUnApplyCustomer".

L�sing: Sj�lfgefi� er n�jasta j�fnun b�ku�. Tiltekna j�fnun m� au�kenna me� detailedEntryNo. Codeunit 226 framfylgir afb�kunarreglum (t.d. engar s��ari f�rslur sem byggja � �essari j�fnun).

Stefna skilabo�a: Innl�g

Studdar t�flur: Cust. Ledger Entry (21)

Sni� bei�ni

Cloud Event f�ribreytur:

*F�rsluna m� einnig au�kenna me� systemId, recordSystemId, id, entryNo e�a entryNumber � bei�nar-JSON.

Bei�nar-JSON:

Svar

Toppreitir: status, entryNo, recordSystemId, customerNo, reversedDetailedEntryNo, reversedAmount, postingDate, documentNo, remainingAmount, open.

Villu�stand

• Au�kenni vantar.
• F�rsla fannst ekki.
• Engin b�ku� j�fnun til a� baka.
• detailedEntryNo er ekki til e�a ekki Application f�rsla.
• Codeunit 226 hafna�i afb�kun.

Tengdar skilabo�ategundir

• Customer.Application.Post - Jafnar f�rslur vi�skiptavinar.

Sales.Quote.MakeOrder

Tilgangur: Breytir s�lutilbo�i (Sales Quote) � s�lup�ntun (Sales Order).

Stefna: Innl�g (a�ger�arbei�ni)

S�utafla: Sales Header (36)

L�sing: Kallar � sta�la� BC Codeunit "Sales-Quote to Order" (codeunit 86) til a� breyta s�lutilbo�i � s�lup�ntun. Upprunalega tilbo�inu er eytt og n� s�lup�ntun stofnu� me� sama vi�skiptavin, l�nur og v�ddir. Skilar n�ja p�ntunarn�merinu �samt lykilreitum hauss.

Bei�nasni�m�t

Au�kennisr�� fyrir subject

Gildi subject er flett upp gegnum FindSalesHeader:

1. Ef subject er gilt GUID ? GetBySystemId
2. Annars ? Get eftir skjalan�meri yfir allar s�lu-skjalategundir

Skjali� sem fannst ver�ur a� hafa Document Type = Quote, annars skilar villu.

D�mi um bei�ni

{
  "specversion": "1.0",
  "type": "Sales.Quote.MakeOrder",
  "source": "MyApp v1.0",
  "subject": "SQ-001"
}

Svarsni�m�t (Success)

{
  "status": "Success",
  "quoteNo": "SQ-001",
  "orderNo": "SO-005",
  "orderSystemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "customerNo": "10000",
  "customerName": "Adatum Corporation",
  "documentDate": "2026-03-07",
  "orderDate": "2026-03-07"
}

Svarsreitir

Villusv�r

Tengdar skilabo�ategundir

• Sales.Document.Create: Stofna tilbo� fr� grunni
• Sales.Document.Release: Gefa �t p�ntunina sem ver�ur til
• Sales.Document.Post: B�ka p�ntunina sem ver�ur til

Sales.BlanketOrder.MakeOrder

Tilgangur: Breytir rammap�ntun (Sales Blanket Order) � s�lup�ntun.

Stefna: Innl�g (a�ger�arbei�ni)

S�utafla: Sales Header (36)

L�sing: Kallar � sta�la� BC Codeunit "Blanket Sales Order to Order" (codeunit 87) til a� stofna n�ja s�lup�ntun �t fr� rammap�ntun. L�nur me� Qty. to Ship > 0 f�rast yfir � n�ju p�ntunina; rammap�ntunin lifir �fram og �tistandandi magn l�kkar samkv�mt �v�.

Bei�nasni�m�t

Au�kennisr�� fyrir subject

1. Ef subject er gilt GUID ? GetBySystemId
2. Annars ? Get eftir skjalan�meri yfir allar s�lu-skjalategundir

Skjali� sem fannst ver�ur a� hafa Document Type = Blanket Order, annars skilar villu.

Forsendur

Hver l�na rammap�ntunar sem � a� f�rast yfir ver�ur a� hafa Qty. to Ship > 0 (noti� Data.Records.Set ��ur til a� stilla gildin). L�nur me� n�ll Qty. to Ship eru ekki f�r�ar.

D�mi um bei�ni

{
  "specversion": "1.0",
  "type": "Sales.BlanketOrder.MakeOrder",
  "source": "MyApp v1.0",
  "subject": "SB-001"
}

Svarsni�m�t (Success)

{
  "status": "Success",
  "blanketOrderNo": "SB-001",
  "orderNo": "SO-006",
  "orderSystemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "customerNo": "10000",
  "customerName": "Adatum Corporation",
  "documentDate": "2026-03-07",
  "orderDate": "2026-03-07"
}

Svarsreitir

Villusv�r

Tengdar skilabo�ategundir

• Sales.Document.Create: Stofna rammap�ntun fr� grunni
• Sales.Document.Release: Gefa �t p�ntunina sem ver�ur til
• Sales.Quote.MakeOrder: Systura�ger� fyrir s�lutilbo�

Sales.SalesInvoice.Correct

Tilgangur: Bakfærir bókaðan sölureikning og býr til nýjan drög að sölureikningi til leiðréttingar.

Lýsing: Vefur BC codeunit 1303 Correct Posted Sales Invoice aðferðina CancelPostedInvoiceCreateNewInvoice. Bókar jöfnunarkreditreikning á móti upprunalegum reikningi og býr til nýjan drög að Sales Header (Document Type = Invoice) með gildi frá upprunalega reikningnum.

Stefna skilaboða: Innlæg (Inbound)

Bókunarstýring: G/L. Beiðninni er hafnað ef G/L bókun er ekki virk í Uppsetningu skýjaviðburða.

Röð auðkennisleitar: GUID í gegnum Subject (SystemId) → Subject sem No. (Get) → JSON-lyklar (systemId, recordSystemId, id, invoiceNo, no, documentNo).

Inntaksbreytur:

{
  "type": "Sales.SalesInvoice.Correct",
  "subject": "POST-INV-000123"
}

Svarsnið:

{
  "status": "Success",
  "originalInvoiceNo": "POST-INV-000123",
  "originalInvoiceId": "5f0d3b6e-...",
  "customerNo": "C00010",
  "customerName": "Customer Ltd.",
  "cancellingCreditMemo": { "no": "PCM-000456", "id": "1a2b3c4d-..." },
  "newDraftInvoice": { "no": "SI-000789", "id": "9f8e7d6c-...", "documentType": "Invoice" }
}

Villuaðstæður:

• Vantar auðkenni → Error með Message subject or request data must contain a record identifier.
• Reikningur fannst ekki → Error.
• Ekki hægt að leiðrétta reikning (þegar bakfærður, greiðslur jafnaðar, tímabil lokað o.s.frv.) → Error með villutexta frá BC og callstack reit.

Ferli:

1. Auðkenni er leyst úr subject eða úr request JSON.
2. G/L bókunarstýring er staðfest.
3. BC CancelPostedInvoiceCreateNewInvoice keyrt í einangruðu Codeunit.Run; villur skila sér sem JSON með callstack.
4. BC bókar jöfnunarkreditreikning, parar hann að fullu við upprunalega reikninginn, og býr til nýjan drög að Sales Header (Document Type = Invoice) afritaðan úr upprunalega reikningnum.
5. Jöfnunarkreditreikningurinn er sóttur í gegnum Cancelled Document (Source ID = 112, Cancelled Doc. No. = upprunalegur reikningur).
6. Upprunalegi reikningurinn, jöfnunarkreditreikningur og nýju drögin eru skilað í einu JSON svari.

Skjöl sem verða til:

Tengingar milli skjala:

• Upprunalegi reikningurinn: Cancelled = true, Canceled By Cr. Memo No. = númer kreditreiknings.
• Kreditreikningur: Applies-to Doc. Type = Invoice, Applies-to Doc. No. = upprunalegi reikningurinn.
• Cancelled Document röð: Source ID = 112, Cancelled Doc. No. = upprunalegur, Cancelled By Doc. No. = kreditreikningur.
• Nýju drögin hafa ekkert reitatengsl við upprunalega; tengingin er aðeins í gegnum þetta svar.

Sækja skjölin með Data.Records.Get:

{ "type": "Data.Records.Get", "data": { "tableName": "Sales Header", "tableView": "WHERE(SystemId=CONST(<newDraftInvoice.id>))" } }

{ "type": "Data.Records.Get", "data": { "tableName": "Sales Cr.Memo Header", "tableView": "WHERE(SystemId=CONST(<cancellingCreditMemo.id>))" } }

{ "type": "Data.Records.Get", "data": { "tableName": "Sales Line", "tableView": "WHERE(Document Type=CONST(Invoice),Document No.=CONST(<newDraftInvoice.no>))" } }

{ "type": "Data.Records.Get", "data": { "tableName": "Sales Cr.Memo Line", "tableView": "WHERE(Document No.=CONST(<cancellingCreditMemo.no>))" } }

{ "type": "Data.Records.Get", "data": { "tableName": "Cancelled Document", "tableView": "WHERE(Source ID=CONST(112),Cancelled Doc. No.=CONST(<originalInvoiceNo>))" } }

Tengdar tegundir skilaboða:

• Sales.SalesInvoice.Cancel - Bakfærir án nýrra draga.
• Sales.Document.Post - Bóka nýja drög að reikningi.

Sales.SalesInvoice.Cancel

Tilgangur: Bakfærir bókaðan sölureikning með því að bóka jöfnunarkreditreikning.

Lýsing: Vefur BC codeunit 1303 Correct Posted Sales Invoice aðferðina CancelPostedInvoice. Bókar jöfnunarkreditreikning á móti upprunalegum reikningi. Ólíkt Correct er enginn nýr drög að reikningi búinn til.

Stefna skilaboða: Innlæg (Inbound)

Bókunarstýring: G/L.

Röð auðkennisleitar: Sama og Sales.SalesInvoice.Correct.

Inntaksbreytur:

{
  "type": "Sales.SalesInvoice.Cancel",
  "subject": "POST-INV-000123"
}

Svarsnið:

{
  "status": "Success",
  "originalInvoiceNo": "POST-INV-000123",
  "originalInvoiceId": "5f0d3b6e-...",
  "customerNo": "C00010",
  "customerName": "Customer Ltd.",
  "cancellingCreditMemo": { "no": "PCM-000456", "id": "1a2b3c4d-..." }
}

newDraftInvoice hluturinn er viljandi sleppt.

Ferli:

1. Auðkenni er leyst úr subject eða úr request JSON.
2. G/L bókunarstýring er staðfest.
3. BC CancelPostedInvoice keyrt í einangruðu Codeunit.Run; villur skila sér sem JSON með callstack.
4. BC bókar jöfnunarkreditreikning og parar hann að fullu við upprunalega reikninginn. Engin drög eru búin til.
5. Jöfnunarkreditreikningurinn er sóttur í gegnum Cancelled Document (Source ID = 112, Cancelled Doc. No. = upprunalegur reikningur).
6. Upprunalegi reikningurinn og jöfnunarkreditreikningurinn skilað í einu JSON svari.

Skjöl sem verða til:

Tengingar milli skjala:

• Upprunalegi reikningurinn: Cancelled = true, Canceled By Cr. Memo No. = númer kreditreiknings.
• Kreditreikningur: Applies-to Doc. Type = Invoice, Applies-to Doc. No. = upprunalegi reikningurinn.
• Cancelled Document röð: Source ID = 112, Cancelled Doc. No. = upprunalegur, Cancelled By Doc. No. = kreditreikningur.

Sækja skjölin með Data.Records.Get:

{ "type": "Data.Records.Get", "data": { "tableName": "Sales Cr.Memo Header", "tableView": "WHERE(SystemId=CONST(<cancellingCreditMemo.id>))" } }

{ "type": "Data.Records.Get", "data": { "tableName": "Sales Cr.Memo Line", "tableView": "WHERE(Document No.=CONST(<cancellingCreditMemo.no>))" } }

{ "type": "Data.Records.Get", "data": { "tableName": "Sales Invoice Header", "tableView": "WHERE(No.=CONST(<originalInvoiceNo>))" } }

{ "type": "Data.Records.Get", "data": { "tableName": "Cancelled Document", "tableView": "WHERE(Source ID=CONST(112),Cancelled Doc. No.=CONST(<originalInvoiceNo>))" } }

Villuaðstæður: Sama og Sales.SalesInvoice.Correct.

Tengdar tegundir skilaboða:

• Sales.SalesInvoice.Correct - Bakfærir og býr til nýja drög til leiðréttingar.

Sales.SalesInvoice.Send

Tilgangur: Sendir bókaðan sölureikning gegnum staðlaðan BC sendingarferil með Document Sending Profile sem leyst er fram.

Lýsing: Vefur utan um BC staðlaða aðferð Sales Invoice Header.SendProfile(var "Document Sending Profile"). Sendingarsniðið er ákveðið með þriggja þrepa keðju (beiðni-yfirskrift → snið viðskiptavinar → sjálfgefið kerfissnið). Sendingaraðgerðin sjálf nýtir staðlaðan BC dispatcher og virðir alla valkosti (Tölvupóstur, Diskur, Prentari, Rafrænt skjal) sem stilltir eru á sniðið.

Stefna: Innlæg.

Bókunarhlið: Engin. Sending skjals býr ekki til bókhaldsfærslur.

Röð uppflettingar á sniði:

1. Beiðni-yfirskrift — ef beiðnin inniheldur documentSendingProfile kóða er hann sóttur og notaður. Ef kóðinn er ekki til skilar beiðnin villu: Document Sending Profile {kóði} not found.. Svarsvæði documentSendingProfileSource = Request.
2. Snið viðskiptavinar — ef Document Sending Profile svæði viðskiptavinarins er sett er það sótt og notað. Ef viðskiptavinurinn vísar í kóða sem er ekki lengur til skilar beiðnin villu: Customer {nr} references Document Sending Profile {kóði} which no longer exists.. Svarsvæði documentSendingProfileSource = Customer.
3. Sjálfgefið kerfissnið — fyrsta Document Sending Profile með Default = true er notað. Svarsvæði documentSendingProfileSource = Default.
4. Engin samsvörun — ef ekkert af ofangreindu leysist skilar beiðnin villu: No Document Sending Profile resolved for customer {nr} and no system default exists..

Röð uppflettingar á skjali:

1. data.invoiceNo
2. data.invoiceId (SystemId)
3. subject (annaðhvort reikningsnúmer eða SystemId GUID; GUID greint sjálfkrafa)

Inntaksbreytur:

{
  "type": "Sales.SalesInvoice.Send",
  "subject": "POST-INV-000123",
  "data": {
    "documentSendingProfile": "EMAIL"
  }
}

Svar við árangri:

{
  "status": "Success",
  "documentType": "PostedSalesInvoice",
  "documentNo": "POST-INV-000123",
  "documentId": "5f0d3b6e-1234-5678-90ab-cdef12345678",
  "customerNo": "C00010",
  "customerName": "Customer Ltd.",
  "documentSendingProfileCode": "EMAIL",
  "documentSendingProfileSource": "Request",
  "message": "Document sent successfully."
}

Svar við villu:

{
  "status": "Error",
  "error": "Document Sending Profile NOSUCH not found.",
  "callstack": "..."
}

Svarsvæði:

Villuaðstæður:

Athugasemdir:

• Sendiverkið sjálft er framkvæmt af SendProfile BC sem er keyrt í einangraðri Codeunit.Run. Allar BC villur eru skilaðar sem JSON án þess að bakka ytri skilaboðafærslu.
• Svarið inniheldur alltaf documentSendingProfileSource svo kallarar geti rakið hvaða leið var farin.
• Sending breytir ekki bókaða reikningnum í BC.

Tengdar tegundir skilaboða:

• Sales.SalesCreditMemo.Send — sama mynstur fyrir bókaða kreditreikninga.
• Sales.SalesInvoice.Pdf — sækja reikning sem PDF í stað þess að senda hann gegnum sendingarferilinn.

Sales.SalesCreditMemo.Send

Tilgangur: Sendir bókaðan sölu-kreditreikning gegnum staðlaðan BC sendingarferil með Document Sending Profile sem leyst er fram.

Lýsing: Vefur utan um BC staðlaða aðferð Sales Cr.Memo Header.SendProfile(var "Document Sending Profile"). Uppfletting á sniði er sú sama og í Sales.SalesInvoice.Send.

Stefna: Innlæg.

Bókunarhlið: Engin.

Röð uppflettingar á sniði: Sú sama og í Sales.SalesInvoice.Send.

Röð uppflettingar á skjali:

1. data.creditMemoNo
2. data.creditMemoId (SystemId)
3. subject

Inntaksbreytur:

{
  "type": "Sales.SalesCreditMemo.Send",
  "subject": "POST-CRM-000456",
  "data": {
    "documentSendingProfile": "EMAIL"
  }
}

Svar við árangri:

{
  "status": "Success",
  "documentType": "PostedSalesCreditMemo",
  "documentNo": "POST-CRM-000456",
  "documentId": "1a2b3c4d-5678-90ab-cdef-1234567890ab",
  "customerNo": "C00010",
  "customerName": "Customer Ltd.",
  "documentSendingProfileCode": "EMAIL",
  "documentSendingProfileSource": "Customer",
  "message": "Document sent successfully."
}

Svar við villu:

{
  "status": "Error",
  "error": "Sales Credit Memo POST-CRM-999999 not found.",
  "callstack": "..."
}

Svarsvæði: Sú sama og Sales.SalesInvoice.Send nema documentType = PostedSalesCreditMemo.

Villuaðstæður: Sú sama og Sales.SalesInvoice.Send nema villan við ófundið skjal er Sales Credit Memo {nr} not found..

Tengdar tegundir skilaboða:

• Sales.SalesInvoice.Send — sama mynstur fyrir bókaða reikninga.
• Sales.SalesCreditMemo.Pdf — sækja kreditreikning sem PDF í stað þess að senda hann gegnum sendingarferilinn.

© Origo – Cloud Events Base Extension