Atualiza nota fiscal/data de faturamento do pedido de venda
Descrição
O endpoint PostUpdateInvoiceNoSalesOrder atualiza a nota fiscal e/ou a data de faturamento de um pedido de venda no sistema MIMS. Ele permite modificar o número da nota fiscal e a data de faturamento, retornando um erro caso o pedido informado não exista no banco de dados.
Request HTTP Post
| Tipo da Requisição | URL Exemplo |
|---|---|
| POST | {{url_base}}/PostUpdateInvoiceNoSalesOrder |
| Exemplo | http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostUpdateInvoiceNoSalesOrder" |
Parâmetros de Entrada
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| SalesOrderNo | String(25) | Sim | Código externo do Pedido de Venda |
| InvoiceNo | String(25) | Não | Número da Nota Fiscal |
| BillingDateOrder | DataHora | Não | Data de Faturamento |
| ErrorIfNotFound | Boolean | Não | Retorna erro caso o pedido informado não exista no banco de dados |
Retorno
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| WebServiceReturn | WebServiceReturn | Sim | Informações padrão de resposta do WebService na execução do método |
Exemplo de Request
POST http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/PostUpdateInvoiceNoSalesOrder
Content-Type: application/json
{
"SalesOrderNo": "SO123",
"InvoiceNo": "INV456",
"BillingDateOrder": "2025-02-20T12:00:00Z"
}
Exemplo de Response
Caso de Sucesso
{
"WebServiceReturn": {
"Success": true,
"Message": "Nota fiscal e data de faturamento atualizados com sucesso."
}
}
Caso de Erro (Pedido Não Encontrado)
{
"WebServiceReturn": {
"Success": false,
"Message": "Pedido de venda não encontrado no banco de dados."
},
"ErrorIfNotFound": true
}
Notas de Dev
- Certifique-se de que
SalesOrderNoseja válido e existente no sistema MIMS antes de tentar a atualização. - O campo
InvoiceNoeBillingDateOrdersão opcionais, mas pelo menos um deles deve ser informado para realizar a atualização. - O campo
BillingDateOrderdeve estar no formato ISO 8601 (ex.:2025-02-20T12:00:00Z). - O campo
ErrorIfNotFound, quandotrue, indica que a operação falhou porque o pedido especificado não foi encontrado no banco de dados. - A atualização é uma operação que modifica dados existentes; valide cuidadosamente os dados antes de executar o método.