Przejdź do głównej zawartości

Uprawnienia

Użyj auth.permissions do nadań, cofnięć, wyszukiwania i sprawdzania statusu operacji uprawnień. Operacje zwracają referencje; odpytuj te referencje zanim uznasz zmianę za zakończoną.

Nadaj uprawnienia

operation = auth.permissions.grant_person(
    subject_type="pesel",
    subject_value="90010112345",
    permissions=["invoice_read"],
    description="Read invoices",
    first_name="Jan",
    last_name="Kowalski",
)

from ksef2.domain.models import EntityPermission

operation = auth.permissions.grant_entity(
    subject_value="1234567890",
    permissions=[EntityPermission(type="invoice_read", can_delegate=False)],
    description="Accounting office read access",
    entity_name="Accounting Sp. z o.o.",
)

operation = auth.permissions.grant_authorization(
    subject_type="nip",
    subject_value="1234567890",
    permission="self_invoicing",
    description="Self-invoicing agreement",
    entity_name="Partner Sp. z o.o.",
)

Sprawdź status operacji

status = auth.permissions.get_operation_status(
    reference_number=operation.reference_number,
)
print(status.status.code, status.status.description)

Wyszukaj i cofnij

from ksef2.domain.models import PersonalPermissionsQuery

page = auth.permissions.query_personal(
    query=PersonalPermissionsQuery(permission_types=["invoice_read"]),
)

for permission in page.permissions:
    print(permission.id, permission.permission_state)

Użyj zwróconego identyfikatora uprawnienia do cofnięcia:

auth.permissions.revoke_common(permission_id="permission-id")
auth.permissions.revoke_authorization(permission_id="authorization-id")

Załączniki

status = auth.permissions.get_attachment_permission_status()
print(status.is_attachment_allowed)

Zalecany przepływ

Nadaj najmniejszy zestaw uprawnień wymagany przez docelowy podmiot.
Zapisz referencję operacji zwróconą przez KSeF.
Odpytaj status operacji przed pokazaniem uprawnienia w aplikacji.
Wyszukaj uprawnienia, aby zebrać identyfikatory do audytu albo cofnięcia.
Cofnij po identyfikatorze uprawnienia, gdy dostęp ma się zakończyć.

Referencja