O que há de novo?

Na API de Autenticação de Concessionárias, adicionamos um modo de simulação disponível nos ambientes de QA. A etapa 1 foi atualizada para usar uma chamada de API em vez de criar manualmente a URL para abrir a página de login do BOSSWeb.

No Registro de Atividades do CRM, esclarecido o mapeamento do status da oportunidade de vendas para o status interno do CRM.

A documentação da API do Registro de Atividades do CRM foi criada e removida da documentação da API de Informações DSP. Ter a função de Registro de Atividades do CRM dentro da documentação da API de Informações DSP gerava confusão.

Atualizada a seção O que está por vir? para remover a API de Oportunidade de Vendas e adicionar a API de Inventário de Unidades de Concessionárias.

Na seção Catálogo de APIs, adicionada a lista de APIs utilizáveis por um CRM.

Na API de Informações DSP, finalizado o payload do Registro de Atividades do CRM.

Na API de Oportunidade de Vendas, finalizados o payload e os testes de certificação.

Na API de Concessionárias, removido o método de envio S0 Standard Ground.

Na API de Pedido de Peças, removido o método de envio S0 Standard Ground.

Na API de Informações DSP, adicionamos o serviço de Registro de Atividades do CRM.

Na API de Peças, atualizados os números de peças a serem usados em alguns testes.

Documentação concluída para a nova API de Oportunidade de Vendas.

In the Parts API, added more information on the kit and sales BOM parts. Also improved the supersession documentation and the usage of the valid_from date.

In the Parts Inventory API, add a description of the availability status codes.

In the Retail Transactions API, added the list and description of the test cases performed during the Test and Dealer Pilot phases.

In the Units API, the trailer object for the Switch products was added to the response. The trailer object includes the trailer's description and prices. The trailer prices are added to the Switch prices.

In the Invoices API, added the delivery_nos query parameter to retrieve invoices using one or many delivery numbers. Also fixed the supercharge_value field, which sometimes included the handling_fee_value field.

In the Parts Order API, added that a parts order can not be modified once it's created.

In the Retail Transactions API, added more information on how to handle warranty jobs. Also, added information on the transaction numbers.

Na API de Balanço de Verificação, os endpoints para autenticação e para envio de dados foram alterados. O provedor, Jackson Dawson, mudou "BRP RISE" para "TrueTrack".

Na API de Unidades, corrigida a descrição do código de status de vendas U8 e UI. Também corrigido o problema que fazia alguns dados faltarem.

Na API de Unidades, adicionados os campos package_label e model_description.

Na API de Inventário de Peças do Concessionário, adicionada uma limitação para indicar que um número de peça com '-' não pode ser usado para chamar o serviço Find Part (Localizador de Peças).

Na API de Autenticação do Concessionário, corrigidos os payloads de resposta.

Na API de Faturas, removida a propriedade cost_value, pois o valor nunca é correto.

Na API de Peças, adicionada a propriedade is_bom para indicar se um número de peça é um kit (BOM).

Na API de Pedidos de Peças, a propriedade dealer PO number agora aceita apenas letras, números e espaços. Caracteres especiais não são permitidos.

Na API de Pedidos de Peças, adicionado o endpoint backorder para recuperar os pedidos com peças em backorder.

Na API de Unidades, adicionada a marca no payload e nos parâmetros de consulta.

Na API de Autenticação de Concessionários, adicionar informações sobre o parâmetro de consulta "state" que pode ser usado para enviar informações para o callback.

Na API de Peças, adicionado o tipo de produto 80 para os manuais. Esclarecido que o parâmetro de consulta "last change date" deve ser pelo menos um dia antes da data atual.

Na resposta de Pedido de Peças, remover o objeto trackings, pois ele está sempre vazio.

Na API de Transações de Varejo, o uso do campo additional_costs foi esclarecido. Esclarecido que as propriedades opcionais no payload devem ser enviadas se estiverem disponíveis no seu DMS. A transação deve incluir custos adicionais se o preço total ao cliente diferir do MSRP. Corrigido o cálculo da taxa de mão de obra com um exemplo de custo fixo. Esclarecido o cálculo de impostos quando apenas o valor total da fatura é conhecido.

A API de Unidades que retorna o catálogo de unidades com descrição, características, preços e links para imagens e documentos técnicos.

A API de Pedido de Unidades que retorna a lista de pedidos de unidades para um concessionário.

Na seção Pedido, Fatura e Entrega, corrigido o exemplo para "Múltiplas Entregas de Múltiplos Pedidos". Modificados os exemplos para a nova API de Pedido de Peças sem o objeto de rastreamento. Atualizada a seção "Rastreamento do Envio" para usar as informações de entrega da API de Entregas.

In the Dealers API, added the Electric Vehicle (EV) qualification level, the business and service hours, and sales zone information. Also update the requirements to indicate that the Dealers API can be called when needed to retrieve the dealer's information, for example when entering the Parts Order screen.

In the Dealer Parts Inventory, clarified the Function Requirement ID 1 to indicate that the dealer's parts inventory must be automatically sent without a dealer manual action. Added Functional Requirement ID 8 to indicate that the API must be called with a full dealer's parts inventory and not one part at a time.

In the Deliveries API, removed the time from the last_change_date_from and last_change_date_to parameters. Indicate that the Deliveries API CAN NOT be used to retrieve unit deliveries. Added information on what to do when the order quantity and delivery quantity are zero.

In the DSP Information API, added documentation on the status 404 Not Found.

In the Invoices API, the maximum value for the limit parameter is 200. Add the invoice_type and invoice_types parameters to the Get Invoices endpoint. Removed the time from the invoice_date_from and invoice_date_to parameters.

In the Parts API, changed the examples to use the V4 version. As requested by many dealers, added the units_of_measure object that contains all the part's measures, like weight and length. IMPORTANT: Only available in the V4 version. Added in the functional requirement ID 1 that no manual action from the dealer is required to update the parts catalogue. Added mandatory functional requirement 7 to display the part's measures to the dealer. Added a recommendation to call the Parts API monthly to get the changes from the last 30 days to avoid missing updates. Added explanation on the difference between the last update date and the valid from date.

In the Parts Order API, added the 'expedited' order type. Added the 'summary' parameter to the Get Orders end-point to retrieve a summary of the parts order. Added the Get Order end-point to retrieve a parts order based on the sales order number. Added explanation and examples of retrieving parts order using the 'summary' parameter to avoid timeouts. Corrected the type for the quantity fields in the query and response payloads: the quantity is an integer and not a number. Added functional requirement 18 (optional): The dealer should be able to retrieve a single parts order using the sales order number. Added functional requirement 19 (optional): The dealer should be able to retrieve parts order summaries.

In the Promotions API, added the section "Understanding Promotions" to provide more examples on the stackable bulletins and more BOSSWeb screen examples.

In the Retail Transactions API, clarified the requirement for the data transmission: no manual dealer action must be required. Added more information on taxes for the parts transactions and how to handle trade-ins in a unit sale. Modified the "rate" field in the additional cost to allow for a negative number.

In the section Order, Invoice, and Delivery: The Complete Story, added an example of parts receiving using the invoice as the entry point.

In the Parts Order API, added the section Order Status to explain the global order status vs the item status. Also clarified DSP Requirements 10 and 11.

In the "Authentication and Credentials" and "Application Authentication API", added that if you worked on the DMS Information or Sales Opportunity V2 APIs, you already have your Application Authentication credentials.

The section Start Here With Mandatory Reading! that provides important information on DCP and the BRP dealers.

Add the section Important: BRP Dealer Operation Standards and Certification that you have to read!

In the Certification Process and Getting Support sections, added information on making sure to use the DCP Certification and Support portal.

In the Parts Order API, added the status on_hold in the header_statuses field of the response. Simplified the delay between calls to the Check service. Added information on the dealer authentication token that must match the dealer number. Also added information and requirements (requirement 17) on displaying the shipping_lines field instead of the ordered_lines field.

In the Retail Transactions API pages, removed mention of V5, the API is V3/V4. Clarified that additional costs that are not included in the total customer price must bot be included in the payload.

In the Warranty Claim API, added missing description for the work_order field.

At the start of each API Catalog section, add the section "Where to Start? Read Me First!" to list the general sections that must be read before started developmen tof an API.

In the Certification Process section, added that the Jira certification ticket must be created only when you start work on an API. Do not use the DCP Jira as a backlog of the work to be done.

In the Trial Balance API, change the field format for the amounts to ±99999999.99 (one less number) since the maximum amounts supported is +/- 99,999,999.99$. Also added that the account nume rand description can't be empty.

In the Technical Information page, in the Error Handling Overview, added information for the status 400 handling: do not send back the payload until the error is corrected.

In the Parts API, clarified the requirements to indicate that the complete parts catalogue must be loaded in the DMS and made available to the dealer.

In the Retail Transactions API, indicates that the total customer cost includes all the additional costs. Also, must use a new UUID if the payload is resent after an error and added information on some error 400. Add information on how the payload exceptions will be managed if a DMS can't send all the requested information.

The Trial Balance API documentation.

In the Unit Warranty Coverage, remove the coverage_status field since the value is always "active".

In the Certification Process, added a warning to not disable the email notification in your Jira account! Added information on how to change a certification ticket state.

In the Deliveries API, the customer_po_no property has been renamed to dealer_po_no to be aligned with the other APIs. Also returns a status 400 if the dealer number is invalid. Added an optional requirement to get the list of deliveries daily.

In the Parts Order API, added information that the sales_order_no property is empty in the Validate response and the Check response for a Validate request. The response returned by the Check service doesn't contain the list of partners. Added information that a timeout can occur with less than 25 items.

In the Parts Order API, added a requirement on the BRP-specific information to be displayed.

The Invoices API now returns a status 400 if the dealer number is invalid.

In the Retail Transactions API, added tests in the DSP Requirements section to send production data to the test environment. To help the transition between the V2 and V4 backend processing, added the requirement to keep the V2 API alive until asked by BRP to shut it down. Add tests to compare invoices in the DMS versus the received data.

In the Retail Transactions API, the transactions.jobs.time_cards.labour_rate property is now optional. Added information on add to handle fix price jobs. The property transactions.units.additional_costs is now mandatory.

In the Parts Inventory API, updated the examples and the parts used for the tests.

The Promotions API used to retrieve unit promotions.

The Unit Warranty Coverage API allows the dealer to retrieve a unit warranty coverage status.

Na seção Welcome, removida a noção de APIs V5. As APIs V3 são para Internacional e as APIs V4 são para América do Norte.

Na seção Technical Information, atualizada a informação sobre strings na seção Response Payload Format: se a informação não estiver disponível para uma string, uma string vazia ("") é retornada e NÃO "NA".

Na seção Certification Process, adicionada a descrição do DCP JIRA usado para solicitar atividades de certificação.

Na seção Getting Support, adicionada a descrição do DCP JIRA usado para solicitar suporte e fazer perguntas.

No Certification Process, adicionadas precisões sobre as fases de garantia de qualidade e piloto de concessionária: a automação deve estar ativa e código em nível de produção deve ser usado.

No API Catalogue, alinhados todos os payloads de mensagens de erro ao padrão descrito na seção Technical Information.

Na Campaigns API, adicionada a exigência de que uma mensagem deve ser exibida ao usuário quando a unidade não tiver campanha ativa.

Na Dealer Parts Inventory API, seção Dealer Parts Inventory Payload Size, adicionadas informações sobre o limite de 30.000 itens no payload e os requisitos e testes relacionados. Também esclarecido quando enviar as atualizações diárias dos dados de inventário de peças do concessionário, mesmo se o concessionário estiver fechado.

A Delivery API agora está disponível para recuperar documentos de entrega de unidades e PA&A para um concessionário.

Na DSP Information API, adicionada exigência para gestão do concessionário.

A Invoices API agora está disponível para recuperar faturas de unidades e PA&A para um concessionário.

Na Parts API, adicionada informação sobre quando chamar para atualizar o catálogo. Esclarecido o requisito de que a atualização diária deve ser automatizada. Adicionada informação sobre a quantidade "no pacote". Adicionada informação sobre preços quando uma peça está obsoleta. Adicionada exigência de localizar um pedido de peças usando um número de entrega ou um número de fatura.

Na Parts Inventory API, corrigido o exemplo JSON para ter os preços como número e não string.

Na Parts Order API, adicionada a tabela de idiomas ausente. Adicionado o parâmetro de cabeçalho Dealer-Number para a chamada Check Order. Adicionada informação sobre o serviço Check que pode ser usado após um Validate e que a validação deve ser feita para todos os pedidos, mesmo aqueles com mais de 30 itens. Também adicionados requisitos para recuperar os pedidos de peças usando Get para tê-los todos no banco de dados do DMS.

Na Retail Transactions API, adicionada a definição dos códigos de trabalho ausentes.

Na Unit Specifications API, adicionado que a propriedade last_status_date pode ser nula se a data da última alteração de status não estiver disponível. Adicionado que um concessionário pode solicitar informações sobre qualquer VIN, mesmo que não o tenha em seu inventário.

new fields in the Unit Specifications API response.

the Parts Order API documentation is finished.

the Dealer Authentication information and API to add information on the redirect URL.

information on the paging mechanism used by some APIs.

the Warranty API documentation.

the Parts Inventory API documentation is finished.

the Retail Transactions API document is finished.

the Dealer Parts Inventory API requirements.

the list of international shipping methods.

the name mapping between the DCP APIs V2 and V3/V4/V5 on the API Catalogue page.

section "What Changed From V2" for all APIs that are changed from the DCP APIs V2.

section "What's Coming?" on the Welcome page to list the upcoming DCP APIs.

in the section Data Sharing a precision on the data sharing consent.

in many API sections that all the number fields with decimals use the dot(.) as the decimal separator. The coma (,) is NOT supported as a decimal separator.

in the Parts API documentation: . A part may be in more than one supersession chain. . Added the sales organization and currencies for V4. . Added validation tests for an invalid part number, a part with missing prices, a vintage part, and an obsolete part.

Section "Navigate the Site"

DSP Information API: added clarification to send only PowerSports dealers. Updated the requirements and validation tests.

Campaigns API documentation.

Articles API documentation.

Retail Transactions API documentation not finished.

Parts Order API documentation not finished.

Sales Opportunity, Automatic Purchase Order, and Warranty Claim APIs are not documented yet.

First release of the DCP portal.