Csatlakozás

A connectPrincipal() a megbízott saját hitelesítésével (Agent kulcs vagy felhasználónév és jelszó) küldi el a megbízó cégadatait és a dedikált felhasználó adatait. A Számlázz.hu az adószám alapján dönti el, hogy új fiókot hoz létre, vagy a meglévőhöz kér csatlakozást.

import { connectPrincipal } from 'kassza/delegation'

const eredmeny = await connectPrincipal(
  {
    principal: {
      name: 'Példa Kft.',
      taxNumber: '12345676-2-42',
      invoicePrefix: 'PLDA',
      zip: '1111',
      city: 'Budapest',
      address: 'Fő utca 1.',
      email: 'penzugy@pelda.hu',
    },
    user: {
      email: 'kassza+pelda@platform.hu',
      password: process.env.DELEGATE_PASSWORD!,
      firstName: 'Platform',
      lastName: 'Számlázás',
    },
  },
  { verifyTaxNumber: true },
)

console.log(eredmeny.status, eredmeny.message)

A megbízott Agent kulcsát a kassza a SZAMLAZZ_AGENT_KEY környezeti változóból veszi, de az agentKey opcióban is megadhatod. A dedikált felhasználó e-mail címe legyen egyedi megbízónként, a jelszava 8 és 128 karakter közötti. Ezeket a hitelesítő adatokat titkosítva tárold, ezekkel fogsz kiállítani.

A négy kimenet#

Ha a Számlázz.hu ismeretlen szöveggel válaszol, a status értéke unknown, és a teljes szöveg a message mezőben van.

Adószám-ellenőrzés#

A verifyTaxNumber: true opcióval a kassza a csatlakozás előtt lekérdezi az adószámot a NAV-tól (a Számlázz.hu adószám-lekérdezésével), és érvénytelen adószámnál el sem küldi a kérést. Egy elgépelt adószám ugyanis új, felesleges fiókot hozna létre.

Hibák#

Kapcsolódó#