Admitir envío

Permite registrar una solicitud de envío de paquetería.


URLs

Ambiente certificación
WSDL
Ambiente producción
WSDL

Parámetros
Nombre Tipo Requerido Observaciones
Usuario texto(50) Si Código Entregado por CorreosChile, para la autenticación con el WS de admisión.
Contrasena texto(50) Sí Clave entregada fija dentro de la configuración del XML.
CodigoAdmision texto(60) Sí Identificador o ID de transacción interna del cliente, con este dato se devolverá el XML de respuesta.
ClienteRemitente texto(11) Sí Código de Cliente SAP, entregado hacia el negocio.
CentroRemitente texto(2) No No aplica.
NombreRemitente texto(60) Sí Nombre del remitente.
DireccionRemitente texto(60) Sí Dirección del remitente.
PaisRemitente texto(5) Sí Por defecto "056".
CodigoPostalRemitente texto(7) No Código postal del remitente.
ComunaRemitente texto(60) Sí Comuna de remitente.
RutRemitente texto(16) No Rut del remitente, formato no validado.
PersonaContactoRemitente texto(5) Sí Persona remitente.
TelefonoContactoRemitente texto(7) No Teléfono contacto remitente.
ClienteDestinatario texto(60) No No aplica.
CentroDestinatario texto(2) No No aplica.
NombreDestinatario texto(60) Sí Nombre del destinatario.
DireccionDestinatario texto(60) Sí Servicio Paquete Express Sucursal (PES):
En este caso debe ingresar aquí el nombre de la sucursal de destino, por ejemplo "SUCURSAL MONEDA"."
Servicio Paquete Express Domicilio (PED):
En este caso debe ingresar aquí la dirección completa del destinatario (calle, número), por ejemplo "Log Nogales 676".
PaisDestinatario texto(5) Sí Por defecto "056".
CodigoPostalDestinatario texto(7) No Devuelto por servicio.
ComunaDestinatario texto(60) Sí Comuna de destinatario, ó comuna de sucursal cuando es un PES.
RutDestinatario texto(16) No Rut de destinatario, formato no validado.
PersonaContactoDestinatario texto(60) No Contacto de destinatario.
TelefonoContactoDestinatario texto(20) Sí Teléfono contacto de destinatario.
CodigoServicio texto(2) Sí Codigo del Servicio a utilizar (ver tabla de codigos de servicios mas abajo)
NumeroTotalPiezas número Sí Normalmente este valor es 1
Existe el concepto de multibulto: dos o mas piezas que usaran el mismo numero de envio (seguimiento) porque van a un mismo destino, en este caso el valor va entre: 2 y 999.
Kilos decimal Sí Peso en kilos separado por "." (ejemplo 1.1).
Volumen Sí Volumen en m3 = (ancho x largo x alto) / 1000000
Fórmula para el producto de paquetería. Si no aplica, enviar 0.
NumeroReferencia texto(24) Sí Referencia del cliente, numero de envió del cliente para su control y trazabilidad interna.
ImporteReembolso número Sí Por defecto 0.
ImporteValorDeclarado número Sí Por defecto 0.
Es obligatorio sí "PagoSeguro" tiene valor "S".
TipoPortes texto(1) Sí Valores: P/D - P: pago en origen - D: pago en destino.
Observaciones texto(255) No Observación.
Observaciones2 texto(255) No Observación.
EmailDestino texto(255) Sí Email del destinatario o en su defecto vacío.
TipoMercancia No Sí Tipo de mercancía que viaja en el bulto o en su defecto vacío.
DevolucionConforme texto(1) Sí Valores: S/N - S: Tiene documentos adicionales N: No tiene documentos.
NumeroDocumentos Número Sí Por defecto 0. Total de documentos sí "DevolucionConforme" = "S".
PagoSeguro Sí "N" por defecto.
"S" si campo DevolucionConforme = "S".

Códigos de servicios
Código Servicio Descripción
24PAQUETE EXPRESS DOMICILIO
25DOCUMENTO EXPRESS
26DOCUMENTO EXPRESS AM
27PAQUETE EXPRESS AM
07PAQUETE EXPRESS SUCURSAL
21CITY BOX NACIONAL

Request


Response


Error


Códigos de error
Código Descripción
ERR_USR_INX Usuario no existe.
ERR_PASS_INC Contraseña incorrecta.
ERR_EXC_DAT Error en la ejecución del procedimiento, en base de datos.
ERR_CON_INX No se encontraron datos para la consulta.
ERR_SRV_USU Servicio no asociado al usuario.
ERR_SRV_INX Servicio no existe.
ERR_CMNCN_OD Error al comunicar con el origen de datos.
ERR_STOU_XML Error con estructura del XML de salida del origen de datos.
ERR_STIN_XML Error con estructura del XML de entrada.
ERR_DATOS_OBLI Faltan datos obligatorios del usuario.
ERR_ACT_TRANS Error al actualizar datos de la tabla LogTransaccional.
ERR_LGIN_INC Nombre usuario o contraseña incorrectos.
ERR_VAD_CD Centro destinatario debe ser menor o igual a 2 dígitos.
ERR_VAD_CR Centro remitente debe ser menor o igual a 2 dígitos.
ERR_VAD_CLD Cliente destinatario debe ser menor o igual a 60 dígitos.
ERR_VAD_CLR Cliente remitente debe ser menor o igual a 60 dígitos y no vacío.
ERR_VAD_CSE código servicio debe ser menor o igual a 2 dígitos y no vacío.
ERR_VAD_ED Email destino debe ser menor o igual a 255 dígitos y no vacío.
ERR_VAD_CPR Código postal remitente debe ser menor o igual a 7 dígitos.
ERR_VAD_CMD Comuna destinatario debe ser menor o igual a 60 dígitos y no vacío.
ERR_VAD_CMR Comuna remitente debe ser menor o igual a 60 dígitos y no vacío.
ERR_VAD_NDOC Número documento debe ser menor o igual a 12 dígitos y no vacío.
ERR_VAD_NUMRE Número referencia debe ser menor o igual a 24 dígitos y no vacío.
ERR_VAD_OBS Observaciones debe ser menor o igual a 255 dígitos.
ERR_VAD_OBS2 Observaciones 2 debe ser menor o igual a 255 dígitos.
ERR_VAD_PD País destinatario debe ser menor o igual a 5 dígitos y no vacío.
ERR_VAD_PR País remitente debe ser menor o igual a 5 dígitos y no vacío.
ERR_VAD_PECTD Persona contacto destinatario debe ser menor o igual a 60 dígitos.
ERR_VAD_PECTR Persona contacto remitente debe ser menor o igual a 60 dígitos.
ERR_VAD_RUTD Rut destinatario debe ser menor o igual a 16 dígitos.
ERR_VAD_RUTR Rut remitente debe ser menor o igual a 16 dígitos.
ERR_VAD_FONOD Formato de teléfono contacto destinatario incorrecto.
ERR_VAD_TIPMER Tipo mercancía debe ser menor o igual a 255 dígitos.
ERR_VAL_GE_I Grabar envío debe ser menor o igual a 1 dígitos, el cual puede ser uno de los siguientes valores: S/N.
ERR_VAD_CAD_I Código admisión debe ser menor o igual a 60 dígitos.
ERR_VAD_CPD_I Código postal destinatario debe ser menor o igual a 7 dígitos y no vacío.
ERR_VAD_DD_I Dirección destinatario debe ser menor o igual a 60 dígitos.
ERR_VAD_DGC_I Delegación conforme debe ser menor o igual a 1 dígitos, el cual puede ser uno de los siguientes valores: S/N.
ERR_VAD_DGO_I Delegación origen debe ser menor o igual a 60 dígitos.
ERR_VAD_DR_I Dirección remitente debe ser menor o igual a 60 dígitos.
ERR_VAD_EN_I Número envío (expe número) debe ser menor o igual a 60 dígitos y no vacío.
ERR_VAD_FONCD_I Teléfono contacto destinatario debe ser menor o igual a 20 dígitos.
ERR_VAD_FONCR_F Formato de teléfono contacto remitente incorrecto.
ERR_VAD_FONCR_I Teléfono contacto remitente debe ser menor o igual a 20 dígitos.
ERR_VAD_IMVDE_F Formato de importe valor declarado incorrecto.
ERR_VAD_IMVDE_I Importe valor declarado debe ser menor o igual a 12 dígitos (incluye separador de enteros con decimales) y no vacío.
ERR_VAD_IREE_F Formato de importe reembolso incorrecto.
ERR_VAD_IREE_I Importe reembolso debe ser menor o igual a 12 dígitos (incluye separador de enteros con decimales).
ERR_VAD_KILOS_F Formato de kilos incorrecto.
ERR_VAD_KILOS_I Kilos debe ser menor o igual a 7 dígitos (incluye separador de enteros con decimales).
ERR_VAD_NDOC_F Formato de número documento incorrecto.
ERR_VAD_NDOC_I Número documento debe ser menor o igual a 12 dígitos.
ERR_VAD_NOMD_I Nombre destinatario debe ser menor o igual a 60 dígitos.
ERR_VAD_NOMR_I Nombre remitente debe ser menor o igual a 60 dígitos.
ERR_VAD_NUMTP_F Formato de número total piezas incorrecto.
ERR_VAD_NUMTP_I Número total piezas debe ser menor a 3 dígitos.
ERR_VAD_PSEG_I Pago seguro debe ser menor o igual a 1 dígitos, el cual puede ser uno de los siguientes valores: S/N.
ERR_VAD_TIPPOR_I Tipo portes debe ser menor o igual a 1 dígitos, el cual puede ser uno de los siguientes valores: P/D.
ERR_VAD_VOLUM_I Volumen debe ser menor o igual a 8 dígitos (incluye separador de enteros con decimales).
ERR_VAD_VOLUM_F Formato de volumen incorrecto.
ERR_VAD_FMT Formato etiqueta debe ser PDF/ PDFS / ZPL.
ERR_CNN_ETQ Error de conexión con el servicio de etiquetas.

Ejemplos
/* New Web Service Client via WSDL
   PackageName: Admision
   import Admision.AdmisionTO;
   import Admision.RespuestaAdmisionTO; */
public RespuestaAdmisionTO AdmitirEnvio(String usuario, String contrasena, String codigoAdmision, String clienteRemitente, String nombreRemitente, String direccionRemitente, 
                                        String codigoPostalRemitente, String comunaRemitente, String rutRemitente, String personaContactoRemitente, String telefonoContactoRemitente,
                                        String nombreDestinatario, String direccionDestinatario, String codigoPostalDestinatario, String comunaDestinatario, String rutDestinatario,
                                        String personaContactoDestinatario, String telefonoContactoDestinatario, String codigoServicio, int numeroTotalPiezas, double kilos, double volumen,
                                        String numeroReferencia, long importeReembolso, long importeValorDeclarado, String tipoPortes, String observaciones, String observaciones2,
                                        String emailDestino, String tipoMercancia, String devolucionConforme, long numeroDocumentos, String pagoSeguro) throws Exception
{
    try
    {
        AdmisionTO admisionTo = new AdmisionTO();
        admisionTo.setCodigoAdmision(codigoAdmision);
        admisionTo.setClienteRemitente(clienteRemitente);
        admisionTo.setCentroRemitente("");
        admisionTo.setNombreRemitente(nombreRemitente);
        admisionTo.setDireccionRemitente(direccionRemitente);
        admisionTo.setPaisRemitente("056");
        admisionTo.setCodigoPostalRemitente(codigoPostalRemitente);
        admisionTo.setComunaRemitente(comunaRemitente);
        admisionTo.setRutRemitente(rutRemitente);
        admisionTo.setPersonaContactoRemitente(personaContactoRemitente);
        admisionTo.setTelefonoContactoRemitente(telefonoContactoRemitente);
        admisionTo.setNombreDestinatario(nombreDestinatario);
        admisionTo.setDireccionDestinatario(direccionDestinatario);
        admisionTo.setPaisDestinatario("056");
        admisionTo.setCodigoPostalDestinatario(codigoPostalDestinatario);
        admisionTo.setComunaDestinatario(comunaDestinatario);
        admisionTo.setRutDestinatario(rutDestinatario);
        admisionTo.setPersonaContactoDestinatario(personaContactoDestinatario);
        admisionTo.setTelefonoContactoDestinatario(telefonoContactoDestinatario);
        admisionTo.setCodigoServicio(codigoServicio);
        admisionTo.setNumeroTotalPiezas(numeroTotalPiezas);
        admisionTo.setKilos(kilos);
        admisionTo.setVolumen(volumen);
        admisionTo.setNumeroReferencia(numeroReferencia);
        admisionTo.setImporteReembolso(importeReembolso);
        admisionTo.setImporteValorDeclarado(importeValorDeclarado);
        admisionTo.setTipoPortes(tipoPortes);
        admisionTo.setObservaciones(observaciones);
        admisionTo.setObservaciones2(observaciones2);
        admisionTo.setEmailDestino(emailDestino);
        admisionTo.setTipoMercancia(tipoMercancia);
        admisionTo.setDevolucionConforme(devolucionConforme);
        admisionTo.setNumeroDocumentos(numeroDocumentos);
        admisionTo.setPagoSeguro(pagoSeguro);
        
        Admision.ServicioExternoAdmisionCEP service = new Admision.ServicioExternoAdmisionCEP();
        Admision.ServicioExternoAdmisionCEPSoap port = service.getServicioExternoAdmisionCEPSoap();
        Admision.RespuestaAdmisionTO respuestaAdmision = port.admitirEnvio(usuario, contrasena, admisionTo);
        return respuestaAdmision;
    }
    catch(Exception exception)
    {
        throw new Exception("Ocurrio un error intentando realizar la admisión del envío.", exception);
    }
}
    function AdmitirEnvio($wsdlUrl, $usuario, $contrasena, $codigoAdmision, $clienteRemitente, $nombreRemitente, $direccionRemitente, 
                          $codigoPostalRemitente, $comunaRemitente, $rutRemitente, $personaContactoRemitente, $telefonoContactoRemitente,
                          $nombreDestinatario, $direccionDestinatario, $codigoPostalDestinatario, $comunaDestinatario, $rutDestinatario,
                          $personaContactoDestinatario, $telefonoContactoDestinatario, $codigoServicio, $numeroTotalPiezas, $kilos, $volumen,
                          $numeroReferencia, $importeReembolso, $importeValorDeclarado, $tipoPortes, $bservaciones, $observaciones2,
                          $emailDestino, $tipoMercancia, $devolucionConforme, $numeroDocumentos, $pagoSeguro)
    {
        try
        {
            $client = new SoapClient($wsdlUrl, array('trace' => 1, 'exception' => 0));
            $result = $client->__soapCall('admitirEnvio', array(
                'admitirEnvio' => array(
                    'usuario' => $usuario,
                    'contrasena' => $contrasena,
                    'admisionTo' => array(
                        'CodigoAdmision' => $codigoAdmision,
                        'ClienteRemitente' => $clienteRemitente,
                        'CentroRemitente' => '',
                        'NombreRemitente' => $nombreRemitente,
                        'DireccionRemitente' => $direccionRemitente,
                        'PaisRemitente' => '056',
                        'CodigoPostalRemitente' => $codigoPostalRemitente,
                        'ComunaRemitente' => $comunaRemitente,
                        'RutRemitente' => $rutRemitente,
                        'PersonaContactoRemitente' => $personaContactoRemitente,
                        'TelefonoContactoRemitente' => $telefonoContactoRemitente,
                        'CentroDestinatario' => '',
                        'NombreDestinatario' => $nombreDestinatario,
                        'DireccionDestinatario' => $direccionDestinatario,
                        'PaisDestinatario' => '056',
                        'CodigoPostalDestinatario' => $codigoPostalDestinatario,
                        'ComunaDestinatario' => $comunaDestinatario,
                        'RutDestinatario' => $rutDestinatario,
                        'PersonaContactoDestinatario' => $personaContactoDestinatario,
                        'TelefonoContactoDestinatario' => $telefonoContactoDestinatario,
                        'CodigoServicio' => $codigoServicio,
                        'NumeroTotalPiezas' => $numeroTotalPiezas,
                        'Kilos' => $kilos,
                        'Volumen' => $volumen,
                        'NumeroReferencia' => $numeroReferencia,
                        'ImporteReembolso' => $importeReembolso,
                        'ImporteValorDeclarado' => $importeValorDeclarado,
                        'TipoPortes' => $tipoPortes,
                        'Observaciones' => $bservaciones,
                        'Observaciones2' => $observaciones2,
                        'EmailDestino' => $emailDestino,
                        'TipoMercancia' => $tipoMercancia,
                        'DevolucionConforme' => $devolucionConforme,
                        'NumeroDocumentos' => $numeroDocumentos,
                        'PagoSeguro' => $pagoSeguro
                    ),
                )), null, null);
            return $result->admitirEnvioResult;
        }
        catch (Exception $e) {
            throw new Exception('Ocurrio un error intentando realizar la admisión del envío.', 0, $e);
        }
    }
/* Add Service Reference namespace Admision
   using Admision; */
public RespuestaAdmisionTO AdmitirEnvio(string usuario, string contrasena, string codigoAdmision, string clienteRemitente, string nombreRemitente, string direccionRemitente, 
                                        string codigoPostalRemitente, string comunaRemitente, string rutRemitente, string personaContactoRemitente, string telefonoContactoRemitente,
                                        string nombreDestinatario, string direccionDestinatario, string codigoPostalDestinatario, string comunaDestinatario, string rutDestinatario,
                                        string personaContactoDestinatario, string telefonoContactoDestinatario, string codigoServicio, int numeroTotalPiezas, double kilos, double volumen,
                                        string numeroReferencia, long importeReembolso, long importeValorDeclarado, string tipoPortes, string observaciones, string observaciones2,
                                        string emailDestino, string tipoMercancia, string devolucionConforme, long numeroDocumentos, string pagoSeguro)
{
    try
    {
        var admisionTo = new AdmisionTO()
        {
            CodigoAdmision = codigoAdmision,
            ClienteRemitente = clienteRemitente,
            CentroRemitente = "",
            NombreRemitente = nombreRemitente,
            DireccionRemitente = direccionRemitente,
            PaisRemitente = "056",
            CodigoPostalRemitente = codigoPostalRemitente,
            ComunaRemitente = comunaRemitente,
            RutRemitente = rutRemitente,
            PersonaContactoRemitente = personaContactoRemitente,
            TelefonoContactoRemitente = telefonoContactoRemitente,
            NombreDestinatario = nombreDestinatario,
            DireccionDestinatario = direccionDestinatario,
            PaisDestinatario = "056",
            CodigoPostalDestinatario = codigoPostalDestinatario,
            ComunaDestinatario = comunaDestinatario,
            RutDestinatario = rutDestinatario,
            PersonaContactoDestinatario = personaContactoDestinatario,
            TelefonoContactoDestinatario = telefonoContactoDestinatario,
            CodigoServicio = codigoServicio,
            NumeroTotalPiezas = numeroTotalPiezas,
            Kilos = kilos,
            Volumen = volumen,
            NumeroReferencia = numeroReferencia,
            ImporteReembolso = importeReembolso,
            ImporteValorDeclarado = importeValorDeclarado,
            TipoPortes = tipoPortes,
            Observaciones = observaciones,
            Observaciones2 = observaciones2,
            EmailDestino = emailDestino,
            TipoMercancia = tipoMercancia,
            DevolucionConforme = devolucionConforme,
            NumeroDocumentos = numeroDocumentos,
            PagoSeguro = pagoSeguro
        };
        var client = new ServicioExternoAdmisionCEPSoapClient();
        var respuestaAdmision = client.admitirEnvio(usuario, contrasena, admisionTo);
        return respuestaAdmision;
    }
    catch (Exception ex)
    {
        throw new Exception("Ocurrio un error intentando realizar la admisión del envío.", ex);
    }
}