Changes for page ../credit-account

Last modified by David Persson on 2022/08/11 10:52

From version 3.1

edited by David Persson
on 2019/12/04 09:48

To version 3.2

edited by David Persson
on 2019/12/04 10:04

Change comment: There is no comment for this version

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -33,69
          +33,65 @@
  Content-Type: application/json
  {
--    "sellerNumber" : "654",
--     "invoice" : {
--        "amountInclVat" : 100,
--        "currency" : "SEK",
--        "invoiceNumber" : "852",
--        "dueDate" : "2019-06-27",
--        "collectionReferenceText" : "Shoes",
--        "invoiceDate" : "2019-06-07",
--        "distributionDate" : "2019-06-08"
--     },
--     "buyer" : {
--        "emailAddress" : "test@testshop.se",
--        "cellPhone" : "+46701234456",
--        "nationalConsumerIdentifier" : {
--            "value" : "19101010-1010",
--            "countryCode" : "SE"
--        },
--        "nationalOrganizationIdentifier" : {
--            "value" : null,
--            "countryCode" : null
--        },
--        "invoiceAddress" : {
--            "name" : "John Smith",
--            "streetAddress" : "Teststreet",
--            "city" : "Testcity",
--            "coAddress" : "",
--            "zipCode" : "12345",
--            "countryCode" : "SE"
--        }
++    "@id": "/ledger/credit-account/v1/501/accounts/123456",
++    "accountNo": "1234567",
++    "startDate": "2016-05-21",
++    "description": null,
++    "accountProfileType": "strex | kontodebet | kontokredit | kontofaktura", //Nytt begrepp
++    "accountAlias" : "Coop kontokredit | Coop matkonto",
++    "customerNo" : "123789654",
++    "status" : "open | pending-close | closed",
++    "creditLimit": 2000.00, // Kontots kreditlimit
++    "unpaidBilledAmount" : 200.0, //total aktuell summa av alla balanser på BillingAcc (endast om negativ/skuld, annars 0)
++    "debt": 2050.0, // total aktuell summa av alla balanser (kapital/ränta/avgifter osv.) på BillingAcc + underliggande CredAccs, OM NEGATIV (skuld)
++    "surplus": 0.0, // total aktuell summa av alla balanser (kapital/ränta/avgifter osv.) på BillingAcc + underliggande CredAccs, OM POSITIV (tillgodo)
++    "reservedAmount": 50.0, // Summerat belopp på alla utestående reservationer mot kontot (som är giltiga och ej captured)
++    "availableAmount": 100.0, // Tillgänglig kredit (kan ej räknas fram utifrån ovan belopp då avgifter kan ingå där, som inte påverkar tillgänglig kredit)
++    "openBill" : {
++        "amount" : 250.0,
++        "bill" : "/ledger/credit-account/v1/501/accounts/123456/bills/963",
++        "dueDate" : "2019-10-10",
++        "billType" : "Bill"
      },
--    "invoicePurchaseDetails" : {
--        "paymentReference" : "426523791",
--        "paymentAccount" : {
--            "accountType" : "BGSE",
--            "accountNumber" : "1234-45",
--            "bic" : "SWEDSESS",
--            "iban" : "SE4550000000058398257466"
--        },
--        "invoiceDenuntiationText" : "Vår fordran enligt denna faktura har pantsatts till Acquirer AB ............"
--     },
--    "authorizationId" : 123,
--    "@id" : "/ledger/invoice-purchase/v1/501/authorizations/123",
--    "parentHREF": "/",
--    "operations" : [
++    "charityDonation": true,
++    "interestRate": {
++        "debtInterest" : 10.00,
++        "penaltyInterest": 15.00
++    },
++    "offer" : "", //nödvändig??
++    "directDebit": "/ledger/credit-account/v1/501/accounts/123456/direct-debit",
++    "cards": "/ledger/credit-account/v1/501/accounts/123456/cards",
++    "transactions": "/ledger/credit-account/v1/501/accounts/123456/transactions",
++    "currency": "sek",
++    "bills": "/ledger/credit-account/v1/501/accounts/123456/bills",
++    "customer": "/ledger/customers/v1/501/customer/123456",
++    "operation" : [
          {
--            "rel" : "create-capture",
++            "rel" : "add-card-info",
              "method" : "post",
--            "href" : "/ledger/invoice-purchase/v1/501/authorizations/123/captures"
++            "href" : "/ledger/credit-account/v1/501/accounts/123456/cards"
          },
          {
--            "rel" : "create-credit",
++            "rel" : "request-close-account", // -> pending-close status (workitem för stängning)
              "method" : "post",
--            "href" : "/ledger/invoice-purchase/v1/501/authorizations/123/credits"
++            "href" : "/ledger/credit-account/v1/501/accounts/123456/request-close-account"
          },
          {
--            "rel" : "create-cancellation",
++            "rel" : "apply-for-raised-credit-limit",
              "method" : "post",
--            "href" : "/ledger/invoice-purchase/v1/501/authorizations/123/cancellations"
++            "href" : "/ledger/credit-account-onboardings/v1/501/accounts/123456/apply-for-raised-credit-limit"
++        },
++        {
++            "rel" : "lower-credit-limit",
++            "method" : "patch",
++            "href" : "/ledger/credit-account-onboardings/v1/501/accounts/123456"
++        },
++        {
++            "rel" : "change-charity-donation",
++            "method" : "patch",
++            "href" : "/ledger/credit-account-onboardings/v1/501/accounts/123456"
          }
--    ],
--    "captures": "/ledger/invoice-purchase/v1/501/authorizations/123/captures",
--    "credits" : "/ledger/invoice-purchase/v1/501/authorizations/123/credits",
--    "cancellations" : "/ledger/invoice-purchase/v1/501/authorizations/123/cancellations"
++    ]
  }
  {{/code}}
@@ -137,38
          +137,67 @@
  (% class="wikigeneratedid" %)
  (% class="small" %)##//* Either buyer.nationalConsumerIdentifier or buyer.nationalOrganizationIdentifier must be specified in the request//##
--== Captures ==
++== Bills ==
--If the seller decides to proceed with the process and let the acquirer purchase the invoice, a call to ##captures## must be made. A post request is sent to the specific ##capture## URL (that was provided in the authorization resource response), the request must contain the actual PDF of the invoice that is to be distributed to the buyer.
++list bills
--[[image:InvoicePurchase external - Capture.svg||height="443" width="844"]]
--
--To capture the authorization (with authorizationId 123 in the example below) and complete the invoice purchase, we need to perform a post request as below
--
  {{code language="http" title="**Request**"}}
--POST /ledger/invoice-purchase/v1/XXX/authorization/123/captures HTTP/1.1
++GET /ledger/credit-account/v1/XXX/accounts/123/bills HTTP/1.1
  Host: -
  Authorization: Bearer <Token>
  Content-Type: application/json
--{
--    "invoicePdfData" : ""
++{{/code}}
++
++
++{{code language="http" title="**Response**"}}
++HTTP/1.1 200 OK
++Content-Type: application/json
++
++{
++    "bills" : [
++        { "billDate" : "2018-09-01", "status" : "open", "billAmount" : 374.10, "@id" : "/ledger/credit-account/v1/501/accounts/123456/bills/963" },
++        { "billDate" : "2018-08-01", "status" : "closed", "billAmount" : 374.10, "@id" : "/ledger/credit-account/v1/501/accounts/123456/bills/852" },
++        { "billDate" : "2018-07-01", "status" : "closed", "billAmount" : 374.10, "@id" : "/ledger/credit-account/v1/501/accounts/123456/bills/741" }
++    ]
  }
  {{/code}}
--**Request properties**
--(% class="table-bordered table-striped" %)
--|=Property|=Data type|=Required in post|=Format|=Description
--|##invoicePdfData##|##string##|Y|Base64 encoded byte array|data of the valid pdf document/invoice
++{{code language="http" title="**Request**"}}
++GET /ledger/credit-account/v1/XXX/accounts/123/bills/456 HTTP/1.1
++Host: -
++Authorization: Bearer <Token>
++Content-Type: application/json
--If the capture succeeds, it should respond with http status 204
++{{/code}}
++bills
++
  {{code language="http" title="**Response**"}}
--HTTP/1.1 201 Created
++HTTP/1.1 200 OK
  Content-Type: application/json
--{
++{
++    "@id": "/ledger/credit-account/v1/501/accounts/123456/bills/963",
++    "externalReference": "123456",
++    "dueDate": "2018-12-05",
++    "billNo": "124645",
++    "amountToBePayed": 240.00, //kan inte denna heta bara "amount" egentligen?
++    "billType" : "Bill",
++    "bankPayment": {
++        "bankAccountNo": "123",
++        "bankAccountType": "BGSE",
++        "bic": "123456",
++        "iban": "SE12345678945631",
++        "paymentReference": "1246fdsdf4687613"
++    },
++    "activePaymentOrder": {
++        "paymentType": "BGAGSE",
++        "executionDate": "2019-01-01",
++        "amount" : 200.0 //beroende på directdebittype så kan denna vara beräknad vid varje hämtning (utifrån ev. delbet)
++    },
++    "pdf": "/ledger/credit-account/v1/501/accounts/123456/bills/963/pdf" //visar senaste ev. childbill?
  }
  {{/code}}