This page is also available in English.

Capability sets: vælg præcis, hvad du modtager

Albert Haff

Alle deltagere på Peppol og NemHandel offentliggør, hvilke dokumenter de kan modtage. Afsendere slår det op, før de sender noget, så det, du offentliggør, afgør, hvad der lander i din indbakke.

Indtil nu har eCourier registreret alle deltagere med det samme standardsæt af profiler. Med capability sets bestemmer du selv, hvilke profiler og dokumenttyper hver af dine deltagere tager imod.

Hvad er et capability set?

I eCourier er et capability set (da: sæt af kapabiliteter) en navngiven samling af profiler, som du kan tildele en eller flere deltagere. En profil beskriver en forretningsproces på netværket, fx Peppol BIS Billing 3.0 eller OIOUBL Simple ordering with simple billing.

For hver profil vælger du, hvilken rolle du har i processen:

  • Kunde: du modtager de dokumenter, en køber modtager, fx fakturaer og kreditnotaer.
  • Leverandør: du modtager de dokumenter, en sælger modtager, fx ordrer eller fakturasvar.

I dag kan du vælge mellem Peppol BIS Billing, Invoice Response og Message Level Response på Peppol og mere end 20 OIOUBL-profiler på NemHandel, som dækker fakturering, bestilling og svar.

Hvorfor det er vigtigt

  • Modtag kun det, du kan håndtere. Hvis dit system kun behandler fakturaer, er der ingen grund til at oplyse, at du tager imod ordrer. Afsendere ser præcis det, du understøtter, og intet andet.
  • Forskellige opsætninger til forskellige virksomheder. Én virksomhed modtager måske kun fakturaer, mens en anden også bestiller via netværket. Opret et sæt til hver, og tildel dem efter behov.
  • Til- og fravælg svar. Vil du have Invoice Responses eller Message Level Responses retur fra dine kunders systemer? Tilføj profilen, så kan du findes til det.

Kom i gang

I portalen går du til Network → Capability sets og opretter et nyt sæt. Tilføj de profiler, du har brug for, vælg rollen for hver, og tildel sættet, når du opretter eller redigerer en deltager.

Du kan også tildele et sæt via API'et ved at sende capability_set_id med, når du opretter eller opdaterer en deltager:

PATCH /v1/participants/{participant}
Content-Type: application/json

{
  "capability_set_id": "01k9x3c8w2r7m4n6p5q1t0v8yz"
}

Svar for deltagere indeholder nu det tildelte sæt som capability_set med id og name. Send null for at gå tilbage til standardprofilerne.

Et par ting, du skal vide:

  • eCourier offentliggør ændringerne i Peppol- og NemHandel-registrene for dig. Du skal ikke selv opdatere noget på netværket.
  • Deltagere uden et capability set beholder standardprofilerne, så intet ændrer sig, før du tildeler et.
  • Et sæt skal indeholde mindst én profil for hver kanal, deltageren er registreret på.
  • Test og produktion er adskilt, så du kan afprøve et sæt på testdeltagere, før du bruger det i produktion.

Næste skridt: hele NemHandel-kataloget

Vi arbejder på understøttelse af hele NemHandels dokumentkatalog. Når det er på plads, kan du tilføje alle NemHandel-dokumenttyper til et capability set og modtage dem via det samme API, som du allerede bruger.

Er der en dokumenttype, du gerne vil have, at vi prioriterer? Kontakt os. Vi vil meget gerne høre, hvad du har brug for.