README

本仓库的目的是提供PHP 8.1中的一个用于与Correios运费计算集成的库。

如何安装

只需使用以下命令通过composer进行安装

composer require correios/correios-calculate

如何使用

使用该库之前，需要首先按照以下方式构建一个计算对象

$package = ShippingPackageDTO();
$package->setGrossWeight(2);
$package->setWidth(10);
$package->setHeight(10);
$package->setLength(10);

参数如下

grossWeight: 应为整数或浮点数类型，始终以千克计算；
width: 应为整数类型；
height: 应为整数类型；
length: 应为整数类型；

所有参数都是必需的，构建好包对象后，只需实例化并按照以下方式调用即可

$correios = new ShippingCorreiosBO('88790-000');
$calc = $correios->calculateShipping($package, '88750-000');

变量calc将返回一个包含PAC和SEDEX服务代码的数组。
实例化ShippingCorreiosBO时，需要传入原始CEP。
进行计算时，需要传入包对象和目标CEP。
必须提供包对象以及原始和目标CEP。

在此库中传递给Correios的固定参数为

'nCdEmpresa' => '',
'sDsSenha' => '',
'nCdFormato' => 1,
'nVlDiametro' => '0',
'sCdMaoPropria' => 'n',
'nVlValorDeclarado' => '0',
'sCdAvisoRecebimento' => 'n',
'StrRetorno' => 'xml',

将来可能将其改为更动态的形式。

注意：当前该库的覆盖率已达到100%。

correios / correios-calculate

维护者

详细信息

README

如何安装

如何使用