Case Registration

Registrera nya Cases i Amili-systemet. Case Registration används för att initiera inkassoärenden, inklusive kundinformation och associerade fakturor som kräver bearbetning från påminnelsestadiet och framåt.

Case Registration endpoints

GET /case--registrations - Lista case registrations (pagerad)
GET /case--registrations/{id} - Hämta en specifik case registration
POST /case--registrations - Skapa en ny case registration

Se Case för att få åtkomst till registrerade cases.

OBS Det rekommenderas starkt att ladda upp originalfakturan för ett case. Se Media Upload för detta.

Exempel Request

Nedan är ett exempel på att skapa en ny case registration. Andra operationer följer liknande request/response-mönster med samma datastruktur.

URL: POST /case--registrations

Headers:

x-api-key: {your_access_token}
Content-Type: application/json

Request Body:

json

{
  "account": "674dbeaf08847b9501cc9132",
  "creditor": "674dbeb208847b9501cc9138",
  "first_action": "debt_collection",
  "currency": "SEK",
  "customer": {
    "name": "Jane Doe",
    "id_number": "202501012385",
    "address": {
      "address_line_1": "Business Street 456",
      "zip_code": "54321",
      "city": "Gothenburg"
    },
    "mobile_number": "+46709876543",
    "email": "jane.doe@domain.se"
  },
  "debts": [
    {
      "invoice_number": "778899",
      "debt_description": "Consulting fee",
      "invoice_date": "Mon, 16 Jun 2025 00:00:00 GMT",
      "capital_to_claim": 250.0,
      "invoice_due_days_after_invoice_date": 10
    }
  ]
}

Response Code: 201 Created

Response Body:

json

{
  "_updated": "Fri, 04 Jul 2025 13:43:19 GMT",
  "_created": "Fri, 04 Jul 2025 13:43:19 GMT",
  "_etag": "fb0b598d816eaa0085492ba22c7876ecd06f3764",
  "_id": "6867da77eaa52b3ff595b5a5",
  "_status": "OK",
  "_cases": ["6867da7788b9226bb78d716c"],
  "_ocr_numbers": ["6867da77eaa52b3ff595b5aa"],
  "_ocr_numbers_ocr": ["20251852687013699044"]
}

Parametrar

Request Body Properties

Property	Typ	Obligatorisk	Beskrivning
`account`	string	Ja	Account ID
`creditor`	string	Ja	Creditor ID
`first_action`	string	Ja	Initial åtgärd (t.ex. "debt_collection")*
`currency`	string	Ja	Valutakod (för närvarande endast "SEK" stöds)
`customer`	object	Ja	Kundinformation
`debts`	array	Ja	Array av skuldobjekt

Customer Properties

Property	Typ	Obligatorisk	Beskrivning
`name`	string	Ja	Kundens fullständiga namn
`id_number`	string	Ja**	Personnummer eller organisationsnummer
`address`	object	Ja	Kundens adressinformation
`mobile_number`	string	Nej	Kontakttelefonnummer
`email`	string	Nej	Kontakt-e-postadress

Address Properties

Property	Typ	Obligatorisk	Beskrivning
`address_line_1`	string	Ja	Primär adressrad
`zip_code`	string	Ja	Postnummer
`city`	string	Ja	Stadnamn

Debt Properties

Property	Typ	Obligatorisk	Beskrivning
`invoice_number`	string	Ja	Fakturanummer från borgenär
`debt_description`	string	Ja***	Beskrivning av skulden
`invoice_date`	string	Ja	Datum när fakturan utfärdades
`capital_to_claim`	number	Ja	Kapitalbelopp att inkassera
`invoice_due_days_after_invoice_date`	number	Ja	Dagar till förfallodatum efter faktureringsdatum

Response Properties

Property	Typ	Obligatorisk	Beskrivning
`_id`	string	Ja	Registration ID
`_created`	string	Ja	Skapandetidsstämpel
`_updated`	string	Ja	Senaste uppdateringstidsstämpel
`_etag`	string	Ja	Entity tag för samtidighetskontroll
`_status`	string	Ja	Registreringsstatus (t.ex. "OK")*
`_cases`	array	Ja	Array av skapade case IDs
`_ocr_numbers`	array	Ja	Array av OCR-nummer IDs
`_ocr_numbers_ocr`	array	Ja	Array av faktiska OCR-nummer

*) För komplett lista över värden och detaljer, se Case Registration **) Obligatoriskt för verkställighetstjänster ***) Obligatoriskt för inkasso- och verkställighetstjänster

Case Registration ​