Send-InvoiceToYuki

ÜBERSICHT

Überträgt Ausgangsrechnungen (PDF und/oder UBL) per Yuki Archive Webservice (SOAP) in das Yuki-Archiv.

SYNTAX

Send-InvoiceToYuki [-PdfPath] <string> [-UblPath] <string> [-WebServiceAccessKey] <string>
    [-AdministrationId] <string> [[-DomainId] <string>] [[-Folder] <int>] [[-Currency] <string>]
    [[-Amount] <decimal>] [[-CostCategory] <string>] [[-PaymentMethod] <int>] [[-Project] <string>]
    [[-Remarks] <string>] [[-ServiceUri] <string>] [[-TimeoutSec] <int>] [-FailOnError]
    [<CommonParameters>]

BESCHREIBUNG

Nutzt den Archive Web Service (SOAP) statt des Upload Webservice (Upload.aspx). Ablauf:

Authenticate(accessKey) -> sessionID
Optional: SetCurrentDomain(sessionID, domainID)
Upload:
nur eine Datei: UploadDocument(sessionID, fileName, base64, folder, administrationID)
PDF + UBL zusammen: UploadDocumentWithAttachment(sessionID, fileName1, data1, fileName2, data2, folder, administrationID, ...)

Hinweis: Die Dateiinhalte werden als Base64 übertragen. Der Service läuft per SOAP. In Kombination mit einem Accountant/Portal-Key kann SetCurrentDomain notwendig sein.

PARAMETER

-PdfPath

Type: string

Pfad zur PDF-Rechnung. Wenn zusammen mit -UblPath angegeben, wird PDF als Hauptdokument hochgeladen.

-UblPath

Type: string

Pfad zur UBL/XML. Kann auch eine UBL mit embedded PDF sein.

-WebServiceAccessKey

Type: string

Yuki API Key (WebServiceAccessKey). Wird für Authenticate(accessKey) verwendet.

-AdministrationId

Type: string

Ziel-Administration (administrationID) in Yuki.

-DomainId

Type: string

Optional. Domain-ID für SetCurrentDomain(sessionID, domainID). Bei Portal/Accountant Keys oft erforderlich.

-Folder

Type: int
Default: 2

Zielordner in Yuki (z.B. 2 = Sales). Default: 2.

-Currency

Type: string
Default: 'EUR'

Optional (nur relevant bei UploadDocumentWithAttachment). Default: EUR.

-Amount

Type: decimal
Default: 0

Optional (nur relevant bei UploadDocumentWithAttachment). Default: 0.

-CostCategory

Type: string

Optional (nur relevant bei UploadDocumentWithAttachment).

-PaymentMethod

Type: int
Default: 0

Optional (nur relevant bei UploadDocumentWithAttachment). Default: 0.

-Project

Type: string

Optional (nur relevant bei UploadDocumentWithAttachment).

-Remarks

Type: string

Optional (nur relevant bei UploadDocumentWithAttachment).

-ServiceUri

Type: string
Default: 'https://api.yukiworks.be/ws/Archive.asmx'

SOAP Endpoint. Default (Belgien): https://api.yukiworks.be/ws/Archive.asmx

-TimeoutSec

Type: int
Default: 120

Timeout für HTTP Requests.

-FailOnError

Type: switch

Wenn gesetzt: bei Fehler zusätzlich Exception werfen. Ergebnisobjekt steht dann in Exception.Data['YukiResult'].

AUSGABEN

PSCustomObject mit Status je Schritt (Authenticate, SetCurrentDomain, Upload), ResultString und ggf. DocumentId.

BEISPIELE

# Nur PDF hochladen (ein Dokument)
$res = Send-InvoiceToYuki -PdfPath 'C:\Temp\invoice-4711.pdf' -WebServiceAccessKey $key -AdministrationId $adminId -DomainId $domainId

# Nur UBL hochladen (ein Dokument, auch für UBL mit embedded PDF)
$res = Send-InvoiceToYuki -UblPath 'C:\Temp\invoice-4711-ubl-withpdf.xml' -WebServiceAccessKey $key -AdministrationId $adminId -DomainId $domainId

# PDF + UBL als Bundle hochladen (PDF = Hauptdokument, UBL = Attachment)
$res = Send-InvoiceToYuki -PdfPath 'C:\Temp\invoice-4711.pdf' -UblPath 'C:\Temp\invoice-4711-ubl.xml' -WebServiceAccessKey $key -AdministrationId $adminId -DomainId $domainId -Folder 2

HINWEISE

Yuki-API-Doku auf Postman https://documenter.getpostman.com/view/12207912/UVCBB51L#47354208-d45d-4335-b04e-79a49d1c5a39