3 minutes October 1, 2024

Wie lade ich in Shopware 6 Dokumente von einer URL zu einer Bestellung hoch?

Als Entwickler Wenn Sie mit Shopware 6 arbeiten, müssen Sie häufig externe Systeme nahtlos integrieren. Eine häufige Aufgabe ist das Hochladen von Dokumenten, wie z. B. Rechnungen, von externen URLs zu Shopware-Bestellungen über die API der Plattform.

In diesem Artikel führen wir Sie durch das Hochladen einer Rechnung (oder anderer Dokumente) zu einer Shopware 6-Bestellung von einer externen URL über eine API. Wenn Sie Dokumente – wie Rechnungen –, die auf anderen Systemen erstellt oder gespeichert wurden, an Shopware-Bestellungen anhängen müssen, ist diese Methode praktisch.

Problem: Rechnung von einer anderen Website über API hochladen

Manchmal müssen Sie möglicherweise eine Rechnung oder ein Dokument von einer externen Website zu einer Shopware-Bestellung hochladen. Dies kann über eine API-Funktion erfolgen, um das Dokument von der URL abzurufen und in Shopware hochzuladen.

Schritte zum Hochladen von Dokumenten zur Bestellung in Shopware 6

Hier ist die Lösung zum Hochladen eines Dokuments zu einer Bestellung in Shopware 6 mit der folgenden Funktion: uploadDocuments($orderId, $fileUrl).

Schritt 1: Rufen Sie die Datei von der externen URL ab.

Die Funktion beginnt mit dem Abrufen des Dateiinhalts von der externen URL mithilfe der PHP-Methode „file_get_contents()“.

$fileContent = file_get_contents($fileUrl);
„

1 2	$fileContent = file_get_contents($fileUrl); „

Schritt 2: Erstellen Sie eine temporäre Datei.

Sobald der Inhalt abgerufen wurde, besteht der nächste Schritt darin, eine temporäre Datei zu erstellen, in der der abgerufene Inhalt gespeichert wird.

$tempFile = tmpfile();
fwrite($tempFile, $fileContent);
$tempFileMeta = stream_get_meta_data($tempFile);

$tempFile = tmpfile();

fwrite($tempFile, $fileContent);

$tempFileMeta = stream_get_meta_data($tempFile);

Schritt 3: Bereiten Sie das Dateiinformationsobjekt vor.

Erstellen Sie ein Dateiobjekt, das wichtige Dateidetails wie Pfad, Originalname, MIME-Typ und Größe enthält. Diese Informationen werden verwendet, um die Datei zum Hochladen an den Medienhelfer von Shopware zu übergeben.

$file = new \stdClass();
$file->path = $tempFileMeta['uri'];
$file->originalName = 'Dateiname';
$file->mimeType = 'application/pdf';
$file->size = strlen($fileContent);
$file->extension = pathinfo('filename', PATHINFO_EXTENSION);

$file = new \stdClass();

$file->path = $tempFileMeta['uri'];

$file->originalName = 'Dateiname';

$file->mimeType = 'application/pdf';

$file->size = strlen($fileContent);

$file->extension = pathinfo('filename', PATHINFO_EXTENSION);

Schritt 4: Anschließend laden Sie die Datei auf Shopware media hoch.

Über die Funktion „uploadMedia“ des Medienhelfers von Shopware wird die Datei in das Shopware-Mediensystem hochgeladen und erhält eine „mediaId“, die mit dem Bestelldokument verknüpft wird.

$mediaId = $this->mediaHelper->uploadMedia($file, $this->context);

1	$mediaId = $this->mediaHelper->uploadMedia($file, $this->context);

Schließen Sie nach dem Hochladen die temporäre Datei:

fclose($tempFile);

1	fclose($tempFile);

Schritt 5: Bestellung mit hochgeladenem Dokument aktualisieren.

Nachdem das Dokument nun hochgeladen wurde, müssen Sie die Shopware-Bestellung mit diesem Dokument aktualisieren. Dies erfolgt durch Übergabe der Medien-ID und des Dateityps an die Funktion „updateOrderDocuments()“.

$data = [
    "mediaId" => $mediaId,
    "fileType" => $file->mimeType
];
$this->updateOrderDocuments($orderId, $data);
„

$data = [

"mediaId" => $mediaId,

"fileType" => $file->mimeType

];

$this->updateOrderDocuments($orderId, $data);

„

Schritt 6: Erstellen Sie ein Dokument und verknüpfen Sie es mit der Bestellung.

In der Funktion „updateOrderDocuments()“ wird das Dokumenten-Repository verwendet, um ein neues Dokument für die Bestellung zu erstellen. Anhand der Art wird der Dokumenttyp abgerufen (z. B. Rechnung) und das Dokument mit der Bestellung verknüpft.

$documentData = [
    'documentTypeId' => $this->getDocumentTypeId('invoice'),
    'fileType' => $data['fileType'] ?? 'application/pdf',
    'orderId' => $orderId,
    'config' => ['documentNumber' => (string)rand(1000, 9999)],
    'deepLinkCode' => bin2hex(random_bytes(16)),
    'documentMediaFileId' => $data['mediaId'],
    'statisch' => falsch,
    'gesendet' => false
];

$documentRepository->create([$documentData], $this->context);

$documentData = [

'documentTypeId' => $this->getDocumentTypeId('invoice'),

'fileType' => $data['fileType'] ?? 'application/pdf',

'orderId' => $orderId,

'config' => ['documentNumber' => (string)rand(1000, 9999)],

'deepLinkCode' => bin2hex(random_bytes(16)),

'documentMediaFileId' => $data['mediaId'],

'statisch' => falsch,

'gesendet' => false

];

$documentRepository->create([$documentData], $this->context);

Die Funktion „getDocumentTypeId()“ ruft den Dokumenttyp basierend auf dem angegebenen technischen Namen ab (z. B. „Rechnung“):

$documentTypeId = $this->getDocumentTypeId('invoice');

1	$documentTypeId = $this->getDocumentTypeId('invoice');

Vollständige Codelösung

public function uploadDocuments($orderId, $fileUrl)
{
    $fileContent = file_get_contents($fileUrl);

    // Create a temporary file
    $tempFile = tmpfile();
    fwrite($tempFile, $fileContent);
    $tempFileMeta = stream_get_meta_data($tempFile);

    // Prepare file details
    $file = new \stdClass();
    $file->path = $tempFileMeta['uri'];
    $file->originalName = 'filename';
    $file->mimeType = 'application/pdf';
    $file->size = strlen($fileContent);
    $file->extension = pathinfo('filename', PATHINFO_EXTENSION);

    // Upload file to media
    $mediaId = $this->mediaHelper->uploadMedia($file, $this->context);

    // Close temp file
    fclose($tempFile);

    // Update order with document
    $data = [
        "mediaId" => $mediaId,
        "fileType" => $file->mimeType
    ];
    $this->updateOrderDocuments($orderId, $data);
}

private function updateOrderDocuments($orderId, $data)
{
    $documentRepository = $this->container->get('document.repository');
    $documentTypeId = $this->getDocumentTypeId('invoice');

    $documentData = [
        'documentTypeId' => $documentTypeId,
        'fileType' => $data['fileType'] ?? 'application/pdf',
        'orderId' => $orderId,
        'config' => ['documentNumber' => (string)rand(1000, 9999)],
        'deepLinkCode' => bin2hex(random_bytes(16)),
        'documentMediaFileId' => $data['mediaId'],
        'static' => false,
        'sent' => false
    ];

    $documentRepository->create([$documentData], $this->context);
}

private function getDocumentTypeId($technicalName)
{
    $documentTypeRepository = $this->container->get('document_type.repository');
    $criteria = new Criteria();
    $criteria->addFilter(new EqualsFilter('technicalName', $technicalName));

    $documentTypeId = $documentTypeRepository->searchIds($criteria, $this->context)->firstId();

    if (!$documentTypeId) {
        throw new \Exception("Document type '{$technicalName}' not found");
    }

    return $documentTypeId;
}

public function uploadDocuments($orderId, $fileUrl)

{

$fileContent = file_get_contents($fileUrl);

// Create a temporary file

$tempFile = tmpfile();

fwrite($tempFile, $fileContent);

$tempFileMeta = stream_get_meta_data($tempFile);

// Prepare file details

$file = new \stdClass();

$file->path = $tempFileMeta['uri'];

$file->originalName = 'filename';

$file->mimeType = 'application/pdf';

$file->size = strlen($fileContent);

$file->extension = pathinfo('filename', PATHINFO_EXTENSION);

// Upload file to media

$mediaId = $this->mediaHelper->uploadMedia($file, $this->context);

// Close temp file

fclose($tempFile);

// Update order with document

$data = [

"mediaId" => $mediaId,

"fileType" => $file->mimeType

];

$this->updateOrderDocuments($orderId, $data);

}

private function updateOrderDocuments($orderId, $data)

{

$documentRepository = $this->container->get('document.repository');

$documentTypeId = $this->getDocumentTypeId('invoice');

$documentData = [

'documentTypeId' => $documentTypeId,

'fileType' => $data['fileType'] ?? 'application/pdf',

'orderId' => $orderId,

'config' => ['documentNumber' => (string)rand(1000, 9999)],

'deepLinkCode' => bin2hex(random_bytes(16)),

'documentMediaFileId' => $data['mediaId'],

'static' => false,

'sent' => false

];

$documentRepository->create([$documentData], $this->context);

}

private function getDocumentTypeId($technicalName)

{

$documentTypeRepository = $this->container->get('document_type.repository');

$criteria = new Criteria();

$criteria->addFilter(new EqualsFilter('technicalName', $technicalName));

$documentTypeId = $documentTypeRepository->searchIds($criteria, $this->context)->firstId();

if (!$documentTypeId) {

throw new \Exception("Document type '{$technicalName}' not found");

}

return $documentTypeId;

}

Abschluss

Wenn Sie dieser Anleitung folgen, können Sie Rechnungen oder andere Dokumente von externen URLs nahtlos über die API-Integration in Shopware 6 hochladen und an Bestellungen anhängen. Dies ermöglicht die automatisierte Verarbeitung von Dokumenten aus anderen Systemen und verbessert so die Effizienz des Arbeitsablaufs. Für fachkundige Dienstleistungen wenden Sie sich an einen Fachmann Shopware-Agentur für eine reibungslose Umsetzung.

Recent help desk articles

Grüße! Ich bin Aneesh Sreedharan, CEO von 2Hats Logic Solutions. Bei 2Hats Logic Solutions widmen wir uns der Bereitstellung von technischem Fachwissen und der Lösung Ihrer Probleme in der Welt der Technologie. Unsere Blog-Seite dient als Ressource, in der wir Einblicke und Erfahrungen teilen und wertvolle Perspektiven auf Ihre Fragen bieten.