Acceso a Catálogo de Clientes

Con nuestro servicio Enlazatte podrás accesar al catálogo de Clientes de tu sistema Contpaqi Comercial.

Request para crear nuevo cliente

La petición es una petición tipo POST, al endpoint /company/{conmpanyRfc}/customers, en donde {conmpanyRfc} es el RFC de la empresa emisora del documento (API Reference ...), como parámetros QueryString envías el Token que previamente debiste haber generado (Ve como generar un token ...), dentro del body del request enviarás una estructura tipo JSON con la información del registro del catálogo de clientes, en el encabezado del request se envía el Content-Type con valor application/x-www-form-urlencoded.

Consideraciones Request Data

  • CodigoCliente: Este valor debe ser único en tu catálogo de clientes de Contpaqi y debe respetar la nomenclatura de código de cliente configurada en el sistema Contpaqi.
  • RFC: Para el caso de cliente del extranjero usar el RFC generico que autoriza el SAT XEXX010101000.
  • UsoCfdi: Utilizar únicamente los valores validos indicados en la referencia de la API en la definición del modelo de clientes.

public function saveCustomer($data)
{
    try {
        $url = $this->baseUri . 'company/' . $this->empresaRFC .'/customers';

        $response = $this->client->request('POST', $url, array(
            'query' => array('token' => $this->token),
            'body' => json_encode($data)
        ));

        $responseData  = json_decode($response->getBody()->getContents());

        return $responseData;
    } catch (RequestException $e) {
        $errorData = json_decode($e->getResponse()->getBody()->getContents());

        $statusCode = $e->getResponse()->getStatusCode();

        switch ($statusCode) {
            case 400:
                $this->message = 'Token invalido.';
                break;
            case 401:
                $this->message = 'Token expirado.';
                break;
            case 422:
                $this->message = 'Error, al intentar insertar el cliente.';
                break;
            case 500:
                $this->message = 'Error interno.';
                break;
        }

        $this->code = $statusCode;
        $this->errors = $errorData->error->errors;
    }
}
{
    "CodigoCliente": "CLIENTE000011",
    "RFC": "XAXX010101000",
    "RazonSocial": "Empresa Cliente Pruebas SA de CV",
    "UsoCfdi": "03",
    "DomicilioFiscal": {
        "Calle": "Calle 1",
        "NumeroExt": "1",
        "NumeroInt": "2",
        "Colonia": "Mi colonia",
        "Ciudad": "DF",
        "Municipio": "Iztapalapa",
        "Estado": "Distrito Federal",
        "Pais": "Mexico",
        "CP": "52200"
    }
}






















{
    "error": "token_expired"
}


































{
    "error": {
        "message": "Customer could not be created",
        "errors": {
            "RFC": [
                "The rfc format is invalid."
            ]
        },
        "status_code": 422
    }
}

Screenshot Insomnia

Login Insomnia

¿Listo para empezar?

Escribenos y comprueba lo rápido y sencillo que es enlazarte con Contpaqi, genera pedidos, cotizaciones, facturas, pagos, clientes, productos y timbra documentos desde tus propios sistemas aprovechando el protencial de tu empresa al máximo.
Escribenos