Ambiente de Testes e Demonstração PSIntegra
Cadastro de Clientes
Cadastro de Produtos
Informações de Integração
Clientes Cadastrados no Sistema
Novo Cliente
Produtos Cadastrados no Sistema
Novo Produto
Registro de Requisições
Limpar Registros
Documentação da Integração
Usuário e Senha Basic
69a9d7e9-b35a-4c3e-8566-da4cbdee813e:
GET
v1/psintegra/cliente
Recupera Lista de Todos os Clientes Cadastrados
Descrição
Este endpoint público tem como objetivo principal retornar os dados básicos de cada registro de cliente contido no sistema.
URL Completa
https://api.prosperasistemas.com/v1/psintegra/cliente
Headers
Não requer envio de Headers
Query Paramns
filtro[termo]: recebendo uma string, possibilita filtrar clientes buscando pelo id, nome ou documento.
filtro[tipo]: podendo receber valores como PF ou PJ possibilita filtrar clientes pelo tipo.
filtro[status]: podendo receber valores como ativo ou inativo possibilita filtrar clientes pelo seu status.
paginacao: recebendo um boleano com true ou false define se o resultado virá em formato paginado ou em listagem padrão.
pagina: recebendo um inteiro, em casos de resultados paginados define qual página deseja acessar.
itens: recebendo um inteiro, em casos de resultados paginados define quantos itens devem ser recuperados por página.
Body
Não requer envio de Body
GET
v1/psintegra/cliente/{id: inteiro}
Recupera Informações de um Cliente Específico
Descrição
Este endpoint privado, recebe um id de cliente na sua composição, retornando assim informações completas e específicas para um cliente selecionado.
URL Completa
https://api.prosperasistemas.com/v1/psintegra/cliente/:id
Headers
Authorization: Basic YTRkOGU2MTgtMzkxNy00MGVjLTg4NGEtNWQ3ODNlZmE0ODFjOg==
OU
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJQcm9zcGVyYSIsInN1YiI6NTYsImV4cCI6MTc0NzMzMTc2MSwiaWF0IjoxNzQ3MTU4OTYxfQ.dWcem7YmrtX21Kwp0MtpQY2Y8gx4RHewND0CjNmPSUU
Query Paramns
Não requer envio de Query Paramns
Body
Não requer envio de Body
POST
v1/psintegra/cliente
Realizar Cadastro de Novo Cliente
Descrição
Este endpoint privado, recebe um json com informações de um cliente e faz a tratativa dos dados e a inclusão no sistema.
URL Completa
https://api.prosperasistemas.com/v1/psintegra/cliente
Headers
Authorization: Basic YTRkOGU2MTgtMzkxNy00MGVjLTg4NGEtNWQ3ODNlZmE0ODFjOg==
OU
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJQcm9zcGVyYSIsInN1YiI6NTYsImV4cCI6MTc0NzMzMTc2MSwiaWF0IjoxNzQ3MTU4OTYxfQ.dWcem7YmrtX21Kwp0MtpQY2Y8gx4RHewND0CjNmPSUU
Content-Type: application/json
Query Paramns
Não requer envio de Query Paramns
Body
status: podendo receber valores como ativo ou inativo define o status do cliente no sistema. Caso não seja informado será definido por padrão como ativo.
Obrigatóriotipo: podendo receber valores como PF ou PJ define o tipo de cliente.
Obrigatóriodocumento: espera-se receber uma string com o documento do cliente, podendo este representar um CPF ou um CNPJ.
Obrigatórionome: espera-se receber uma string com o nome do cliente.
telefone: espera-se receber uma string com o telefone do cliente, sendo composto por DDD + Número.
Obrigatórioemail: espera-se receber uma string com um e-mail válido do cliente.
cep: espera-se receber uma string com o CEP do endereço do cliente.
uf: espera-se receber uma string com dois caracteres representando a unidade da federação do endereço do cliente.
cidade: espera-se receber uma string com o nome da cidade do endereço do cliente.
bairro: espera-se receber uma string com o nome do bairro do endereço do cliente.
logradouro: espera-se receber uma string com o logradouro do endereço do cliente.
PUT
v1/psintegra/cliente/{id: inteiro}
Realizar Atualizações de um Cliente
Descrição
Este endpoint privado, recebe um json com informações de um produto e faz a tratativa dos dados e os atualiza, podendo ser parcial ou total.
URL Completa
https://api.prosperasistemas.com/v1/psintegra/cliente/:id
Headers
Authorization: Basic YTRkOGU2MTgtMzkxNy00MGVjLTg4NGEtNWQ3ODNlZmE0ODFjOg==
OU
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJQcm9zcGVyYSIsInN1YiI6NTYsImV4cCI6MTc0NzMzMTc2MSwiaWF0IjoxNzQ3MTU4OTYxfQ.dWcem7YmrtX21Kwp0MtpQY2Y8gx4RHewND0CjNmPSUU
Content-Type: application/json
Query Paramns
Não requer envio de Query Paramns
Body
status: podendo receber valores como ativo ou inativo define o status do cliente no sistema. Caso não seja informado será definido por padrão como ativo.
tipo: podendo receber valores como PF ou PJ define o tipo de cliente.
documento: espera-se receber uma string com o documento do cliente, podendo este representar um CPF ou um CNPJ.
nome: espera-se receber uma string com o nome do cliente.
telefone: espera-se receber uma string com o telefone do cliente, sendo composto por DDD + Número.
email: espera-se receber uma string com um e-mail válido do cliente.
cep: espera-se receber uma string com o CEP do endereço do cliente.
uf: espera-se receber uma string com dois caracteres representando a unidade da federação do endereço do cliente.
cidade: espera-se receber uma string com o nome da cidade do endereço do cliente.
bairro: espera-se receber uma string com o nome do bairro do endereço do cliente.
logradouro: espera-se receber uma string com o logradouro do endereço do cliente.
DELETE
v1/psintegra/cliente/{id: inteiro}
Deletar Cliente do Sistema
Descrição
Este endpoint privado, recebe um id de cliente na sua composição, e após validações remove o cliente do sistema de forma definitiva.
URL Completa
https://api.prosperasistemas.com/v1/psintegra/cliente/:id
Headers
Authorization: Basic YTRkOGU2MTgtMzkxNy00MGVjLTg4NGEtNWQ3ODNlZmE0ODFjOg==
OU
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJQcm9zcGVyYSIsInN1YiI6NTYsImV4cCI6MTc0NzMzMTc2MSwiaWF0IjoxNzQ3MTU4OTYxfQ.dWcem7YmrtX21Kwp0MtpQY2Y8gx4RHewND0CjNmPSUU
Query Paramns
Não requer envio de Query Paramns
Body
Não requer envio de Body
GET
v1/psintegra/produto
Recupera Lista de Todos os Produtos Cadastrados
Descrição
Este endpoint público tem como objetivo principal retornar os dados básicos de todos os registros de produto contidos no sistema.
URL Completa
https://api.prosperasistemas.com/v1/psintegra/produto
Headers
Não requer envio de Headers
Query Paramns
filtro[termo]: recebendo uma string, possibilita filtrar produtos buscando pelo id, sku ou descrição.
filtro[status]: podendo receber valores como ativo ou inativo possibilita filtrar produtos pelo seu status.
paginacao: recebendo um boleano com true ou false define se o resultado virá em formato paginado ou em listagem padrão.
pagina: recebendo um inteiro, em casos de resultados paginados define qual página deseja acessar.
itens: recebendo um inteiro, em casos de resultados paginados define quantos itens devem ser recuperados por página.
Body
Não requer envio de Body
GET
v1/psintegra/produto/{id: inteiro}
Recupera Informações de um Produto Específico
Descrição
Este endpoint privado, recebe um id de produto na sua composição, retornando assim informações completas e específicas para um produto selecionado.
URL Completa
https://api.prosperasistemas.com/v1/psintegra/produto/:id
Headers
Authorization: Basic YTRkOGU2MTgtMzkxNy00MGVjLTg4NGEtNWQ3ODNlZmE0ODFjOg==
OU
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJQcm9zcGVyYSIsInN1YiI6NTYsImV4cCI6MTc0NzMzMTc2MSwiaWF0IjoxNzQ3MTU4OTYxfQ.dWcem7YmrtX21Kwp0MtpQY2Y8gx4RHewND0CjNmPSUU
Query Paramns
Não requer envio de Query Paramns
Body
Não requer envio de Body
POST
v1/psintegra/produto
Realizar Cadastro de Novo Produto
Descrição
Este endpoint privado, recebe um json com informações de um produto e faz a tratativa dos dados e a inclusão no sistema.
URL Completa
https://api.prosperasistemas.com/v1/psintegra/produto
Headers
Authorization: Basic YTRkOGU2MTgtMzkxNy00MGVjLTg4NGEtNWQ3ODNlZmE0ODFjOg==
OU
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJQcm9zcGVyYSIsInN1YiI6NTYsImV4cCI6MTc0NzMzMTc2MSwiaWF0IjoxNzQ3MTU4OTYxfQ.dWcem7YmrtX21Kwp0MtpQY2Y8gx4RHewND0CjNmPSUU
Content-Type: application/json
Query Paramns
Não requer envio de Query Paramns
Body
status: podendo receber valores como ativo ou inativo define o status do produto no sistema. Caso não seja informado será definido por padrão como ativo.
Obrigatóriotipo: recebe uma string com o tipo do produto.
grupo: recebe uma string com o grupo do produto.
Obrigatóriosku: espera-se receber uma string com o SKU do produto, este é um valor único e não poderá ser duplicado.
ncm: espera-se receber o código do NCM do produto, será salvo em banco de dados apenas caracteres os numéricos do NCM.
Obrigatóriodescricao: espera receber o nome/descrição identificadora do produto.
PUT
v1/psintegra/produto/{id: inteiro}
Realizar Atualização de um Produto
Descrição
Este endpoint privado, recebe um json com informações de um produto e faz a atualização dos dados recebidos, podendo ser total ou parcial.
URL Completa
https://api.prosperasistemas.com/v1/psintegra/produto/:id
Headers
Authorization: Basic YTRkOGU2MTgtMzkxNy00MGVjLTg4NGEtNWQ3ODNlZmE0ODFjOg==
OU
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJQcm9zcGVyYSIsInN1YiI6NTYsImV4cCI6MTc0NzMzMTc2MSwiaWF0IjoxNzQ3MTU4OTYxfQ.dWcem7YmrtX21Kwp0MtpQY2Y8gx4RHewND0CjNmPSUU
Content-Type: application/json
Query Paramns
Não requer envio de Query Paramns
Body
status: podendo receber valores como ativo ou inativo define o status do produto no sistema. Caso não seja informado será definido por padrão como ativo.
tipo: recebe uma string com o tipo do produto.
grupo: recebe uma string com o grupo do produto.
sku: espera-se receber uma string com o SKU do produto, este é um valor único e não poderá ser duplicado.
ncm: espera-se receber o código do NCM do produto, será salvo em banco de dados apenas caracteres os numéricos do NCM.
descricao: espera receber o nome/descrição identificadora do produto.
DELETE
v1/psintegra/produto/{id: inteiro}
Deletar Produto do Sistema
Descrição
Este endpoint privado, recebe um id de produto na sua composição, e após validações remove o produto do sistema de forma definitiva.
URL Completa
https://api.prosperasistemas.com/v1/psintegra/produto/:id
Headers
Authorization: Basic YTRkOGU2MTgtMzkxNy00MGVjLTg4NGEtNWQ3ODNlZmE0ODFjOg==
OU
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJQcm9zcGVyYSIsInN1YiI6NTYsImV4cCI6MTc0NzMzMTc2MSwiaWF0IjoxNzQ3MTU4OTYxfQ.dWcem7YmrtX21Kwp0MtpQY2Y8gx4RHewND0CjNmPSUU
Query Paramns
Não requer envio de Query Paramns
Body
Não requer envio de Body