magedin / econocargo-php

此 SDK 提供了 PHP 应用程序与 econoCARGO 服务 API 之间的连接。

dev-main 2020-10-27 23:54 UTC

This package is auto-updated.

Last update: 2024-08-28 08:36:43 UTC


README

Build Status Codacy Badge

关于

这是 econoCARGO API 的官方 SDK(软件开发工具包)。本 SDK 旨在帮助 PHP 系统与 econoCARGO API 交互。

安装

使用 composer 安装

要使用 composer 安装,您需要在您的计算机上安装 composer,这样您就可以轻松地将此 SDK 安装到您的项目中。

安装 composer 后,您只需要求此 SDK

> composer require magedin/econocargo-php

使用

要在您的 PHP 系统中使用此 SDK 非常简单。请参考下面的示例,了解如何轻松使用

<?php

use EconoCargo\ApiFactory;
use EconoCargo\Options\Request\QuoteResponseType;

/**
 * Require composer autoload file.
 */
require_once __DIR__ . '/../vendor/autoload.php';

try {
    $api = ApiFactory::create();

    /** Activating testing mode (API Sandbox). */
    $api->config()->service()->isTesting(true);
    $quote = $api->shipping()->quote();
    $quote->setCompanyCNPJ('05663266000219')
        ->setOrderNumber('123456')
        ->setDestinyId('9836')
        ->setDestinyUFName('SP')
        ->setDestinyIBGECode(0)
        ->setDestinyPostcode('04100-000')
        ->setSegmentId(5)
        ->setDestinyCNPJ("12345678901234")
        ->setDestinyCPF("01234567890")
        ->setDimensionsTotalValue(0.9)
        ->setWeightTotalValue(150)
        ->setInvoiceTotalValue(1500)
        ->setCheaperQuote(true)
        ->setResponseQuoteType(QuoteResponseType::TYPE_ALL)
    ;

    $result = $quote->execute();

    $shippingServices = $result->getShippingServices();
} catch (\Exception $e) {
    echo "Some error has happened.";
}