mojitowp/pymexpress

哥斯达黎加邮政新Web Service(Pymexpress)的连接类。

1.0.2 2023-03-02 15:43 UTC

This package is auto-updated.

Last update: 2024-09-03 18:04:20 UTC


README

基于Mojito发货插件的PHP WS客户端

哥斯达黎加邮政新Web Service(Pymexpress)的连接类。如没有连接数据,可以通过jmora {arroba} correos.go.cr邮箱索取。

使用Curl代替SoapClient,这允许在哥斯达黎加邮政的防火墙未授权IP时控制超时。

Pymexpress和其他是哥斯达黎加邮政的自主品牌。

安装

Composer

composer require mojitowp/pymexpress

初始化

$environment接受"sandbox"或"production"(待定:生产URL。目前连接指向sandbox/测试)。

$pymexpress = new Mojito\Pymexpress\Pymexpress_WSC( $username, $password, $user_id, $service_id, $client_code, $environment );

分配代理[可选]

$pymexpress->set_proxy( array(
	'hostname' => 'My Host',
	'username' => 'My Username',
	'password' => 'My Password',
	'port'     => 'My Host port',
));

获取运单号

$guia = $pymexpress->generar_guia();

获取省份

$provincias = $pymexpress->get_provincias();

获取一个省份的市

  • 1 = 圣何塞
$cantones = $pymexpress->get_cantones( '1' );

获取一个市的地区

  • 1 = 圣何塞
  • 01 = 圣何塞
$distritos = $pymexpress->get_distritos( '1', '01' );

获取一个地区的社区

  • 1 = 圣何塞
  • 01 = 圣何塞
  • 01 = 卡门
$barrios = $pymexpress->get_barrios( '1', '01', '01' );

获取邮政编码

  • 1 = 圣何塞
  • 01 = 圣何塞
  • 01 = 卡门
$codigo_postal = $pymexpress->get_codigo_postal( '1', '01', '01' );

获取运费

  • 从圣何塞,卡门发送到圣何塞,卡门,重量1公斤
$tarifa = $pymexpress->get_tarifa( '1', '01', '1', '01', '1000' );

注册发送

订单号

$order_id = '1942';

发送参数

$params   = array(
	'DEST_APARTADO'  => '10101', // Código postal destino
	'DEST_DIRECCION' => '100 mts sur del Wallmart', // Dirección
	'DEST_NOMBRE'    => 'Pedro Perez', // Nombre del destinatario
	'DEST_TELEFONO'  => '22334455', // Teléfono del destinatario
	'DEST_ZIP'       => '10101', // Código postal destino
	'ENVIO_ID'       => 'PY000000000CR', // Número de guía
	'MONTO_FLETE'    => '2500', // Costo del envío
	'OBSERVACIONES'  => 'Ropa y otros productos', // Descripción
	'PESO'           => '2000', // peso en gramos
);

发件人

$sender = array(
	'direction' => 'San José, Pavas',
	'name'      => 'Mi Tienda en línea.com',
	'phone'     => '88776655',
	'zip'       => '20301', // Código postal del remitente
);

发送到哥斯达黎加邮政

$envio = $pymexpress->registro_envio( $order_id, $params, $sender );