README

2023 计划更新

请检查 php8+ 分支

任何 PR 都受欢迎。

correos-de-costa-rica-pymexpress-ws-client

基于 Mojito 运输的 PHP WS 客户端

科斯塔 Rica 邮政新 Web 服务 (Pymexpress) 的连接类。如果您没有这些数据，可以通过 jmora {at} correos.go.cr 邮件索取。

使用 Curl 而不是 SoapClient，这允许在科斯塔 Rica 邮政防火墙中 IP 未授权时控制超时。

Pymexpress 及其他是科斯塔 Rica 邮政的自主品牌。

安装

Composer

composer require nomanualdev/correos-de-costa-rica-pymexpress-ws-client

初始化

$environment 接受 "sandbox" 或 "production"（待定：生产 URL。目前连接指向 sandbox/测试）。

$pymexpress = new 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
);

发送到科斯塔 Rica 邮政

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